










THE 





1581 


TOOLKIT 




What Your 1581 Drive is Missing 


A hammer is a hammer. But without nails, it’s not much of a tool. The 1581 Disk Drive is a 
marvel of technology, capable of some amazing tricks. But without quick and easy access to 
the drive’s capabilities, you may as well have a $200.00 paperweight. 

The 1581 Toolkit is your ticket to getting the full value out of your investment in the 1581 
drive. It gives you the following features. 


Fast Whole Disk Copier 
Byte Pattern Search Tool 
Ultrafast Disk Form alter 
Track & Sector Editor 
Partition Creator 
File Track & Sector Tracer 


1700/64/50 REU Support 
Directory Editor 
Relocatable Fast Loader 
Quick &ror Scanner 
64K Video R AM Support 
Technical Support - Of Course 


Knowledge can be a tool too. And nobody has more knowledge of the 1581 drive than David 
Martin. His book, "The 1581 DOS Reference Guide" is over 100 pages of detailed information 
that took over a full year of solid research to complete! Now all that knowledge can be yours 
at a special savings. Order the 1581 Toolkit and recieve the DOS Reference Guide at NO 
ADDITIONAL CHARGE! 


Don’t let your 1581 Disk Drive be a hammer without nails. Call us today and start getting 
your money’s worth from your drive! 


THE 1581 COMBO P, 

Order #001084 -Now 

(Upgrade from VI - send your original disk + 



-Only $9.95) 
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INTRODUCTION 


For years. Commodore users have been without a 
good, inexpensive mass storage device. With the 
advent of the 1581 disk drive. Commodore now have 
speed and storage power rivaling IBM PCs. Although 
the drive cannot be used to store copy protected 
programs in their native state, it is a great data 
storage device. Those of you who do a lot of word 
processing, data management, or any other activity 
requiring intensive file access will find this disk 
drive a real boon. 

The 1581 Tool Kit has been created to provide 
the user with a set of professional disk utilities. 
It also provides programmers with inside information 
that only hours upon hours of labor can produce. We 
know that the 1581 Tool Kit will become one of your 
favorite utilities. If enough support is shown by the 
user community, we will release an upgrade package 
that will contain enhanced tools. We are open to 
suggestions from Registered Owners, and again, if 
enough support is shown in the way of sales, we will 
implement them. 

As usual, if an upgrade is produced. Registered 
Owners will have the right to purchase it at a 
reduced price. Be sure to send in your Registration 
card before you lose it. 


SYSTEM REQUIREMENTS 

The 1581 Toolkit will operate properly with 
either the Commodore 64 or the Commodore 128/128D in 
64 mode. It requires the use of one or two 1581 disk 
drives. The Fast File Copier will also support the 
1541/1571 disk drives. The 1581 Toolkit will also 
work properly on the Commodore SX portable computer. 


PACKAGE CONTENTS 

The package containing your initial purchase of 
the 1581 Toolkit should contain the following items. 
1> A 1581 Toolkit owners manual, includi ng The 158 ? 
DOS Reference Guide. 2> The 1581 Toolkit diskette. 3> 
The 1581 Toolkit REGISTRATION CARD. 

Take time right now to fill out the REGISTRATION 
CARD, and _s_end it in before you lose it . Sending the 
card is your key to the ownership rights you deserve, 
such as Tech Support and Upgrades. 
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GETTING STARTED 
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To get started, place the 1581 Toolkit diskette 
into the disk drive, and type the following command: 
LOAD "* M ,[device number],1 . For example, if your 
1581 is set as device number 10, type the following: 

LOAD ,10,1 . Press RETURN and the drive should 
begin loading the program. Commodore 128 owners who 
have set their 1581 drive to device #8 need only 
place the 1581 Toolkit disk into the drive and power 
on. The 1581 Toolkit will autoboot to the C-64 mode. 
In a short time, the 1581 Toolkit title screen will 
appear and, seconds later, the Toolkit Main Menu will 
pop up. You can cut the waiting time short by 
pressing the Space Bar. 

The first thing you will notice is a flashing 
box surrounding the first menu selection. By pressing 
the appropriate cursor keys you can move the box in 
the direction you wish. The box will wrap around to 
the next column when using the U/D Cursor key. Any 
menu selection can be chosen by simply positioning 
the box around it and then pressing RETURN. Please 
note that ALL sub-menus operate in a similar manner. 
You will be presented with a Highlight Bar which you 
may position with the U/D Cursor key and hit RETURN 
to select. 

The 1581 Toolkit is composed of ten different 
modules. Each module is designed to return to the 
Main Menu after the selected job is completed. The 
program will always ask you to place the 1581 Toolkit 
disk in the drive with the device number from which 
it was originally booted. For example, if you started 
the program from device #10, it will always ask you 
to place the program disk into the drive with device 
#10. This is why the 1581 Toolkit is supplied only on 
a 3.5 inch disk. We have worked hard to make the 1581 
Toolkit a pleasure to use. As always, we are open to 
your suggestions for improvements. 
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FAST DATA COPIERS 


Fast data copiers are used primarily to make 
fast, reliable backups of unprotected software. The 
1581 Toolkit gives you a choice of using either a 
single drive copier or a dual drive copier. The 
single drive copier will copy a complete disk in 
approximately 10 minutes and 16 disk swaps. If this 
sounds like a lot of time, remember that there is 
over 800,000 bytes of information on a 1581 disk. If 
you have two 1581 drives, you will be happy to know 
that the copying time using the dual drive version is 
only about 2 minutes. 
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From the opening menu, position the flashing box 
around the Fast Data Copier option. Make sure that 
the 1581 Toolkit disk is in the disk drive and press 
RETURN to load the utility. You will be prompted to O 

input an S if you wish to load the (S) ingle Drive 
Data Copier or a D to load the (D)ual Drive Data 
Copier. Let's assume that you have one disk drive, 
and begin with the single drive option. 


Single Data Copier; 

At the (S)ingle or (D)ual prompt, make sure the 
1581 Toolkit disk is in the disk drive and press S. 
The drive will start up and the utility should load 
to the Single Data Copier menu screen. When the Main 
Menu appears, you will be presented with drive 
information and a list of options. 

Let's make a backup of your 1581 Toolkit disk 
itself. Any original disk should be write protected 
before attempting a backup. This reduces the risk of 
damage to your valuable original software. Our 
copiers will always warn you when a write protect is 
needed. With the 1581 Toolkit disk in the drive, 
position the Highlight Bar on the COPY DISK option 
and press RETURN. You will be prompted with "Insert 
Source Disk : Press Return”. Always check to see if 
the proper disk is in the drive. Press RETURN. The 
copier will display the track number that is being 
read and also which pass is in process. After a few 
seconds, you will be prompted to "Insert Destination 
Disk : Press Return". The Destination disk can be a 
new disk, or a disk with no important data on it, as 
it will be formatted as the copying proceeds. After 
the backup disk is in place, press RETURN. The copier 
will now display the track being written and the 
current pass number. When finished writing the 
tracks, you will be prompted to insert the Source 
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disk again. This process of swapping Source and 
Destination disks will be repeated 16 times. 

Both of our Fast Data Copiers have a built in 
data verify feature. Any time a Read Error is 
detected on the source, the copier will attempt to 
read that track again. At the end of the process an 
error report will be displayed. Any errors on the 
Source disk that were not correctable by the verify 
will be listed under the heading of Read Errors:. Any 
errors on the Destination disk will be listed under 
the heading Write Errors:. If there are any errors on 
the Destination disk, we suggest you try copying to a 
different disk. Press Space Bar to return to the Fast 
Data Copier Main Menu. 

The other menu options are: 

REBOOT MAIN MENU: 

When you select this command, the 1581 
Toolkit will ask you to place the Toolkit disk in 
the drive bearing the device number from which you 
first loaded the Toolkit. Press the Space Bar and 
the program will reboot. 

DISK COMMAND: 

This option gives you direct access to the 
1581 drive without the headache of using the OPEN 
statement. All standard disk commands are 
available including the ability to change 
partitions. This option acts as any other standard 
DOS wedge. There is no need to type the < OPEN 
15.8.15. 11 > portion of the command. Simply type in 
the command desired at the flashing cursor. For 
example, to initialize any diskette in the current 
drive, just type in < 10 > . To list the 
directory, use the FI key which is active in this 
mode (see below). 
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STARTING and ENDING TRACK: 

A special feature of the 1581 Toolkit is the 
ability to copy tracks of a disk selectively. 
Using the STARTING TRACK and the ENDING TRACK 
options, you may copy 1 track or a block of tracks 
to another disk. This can be useful to a skilled 
••disk surgeon” for repairing blown disks. Please 
remember two very important things! One, practice 
on unimportant work disks until you know what you 
are doing. Two, just because you copied track 40 
(the directory) does not mean that those files 
were copied to the Destination disk. In fact, you 
may have created a disk that is completely 
unusable by DOS. To modify the default settings, 
place the Highlight Bar over the desired option 
and press RETURN. Enter the desired track number 
using leading zeros if necessary, and press RETURN 
again to lock in your setting. 

F1/F3: 


You may check the directory of the disk 
currently in the drive by pressing FI or F3. 

One last item you should know about the 
Single Data Copier is that the copy process may be 
aborted any time the •• Insert Disk” message is on 
the screen. Simply hit RESTORE. When you do this, 
the Copy Complete screen will be displayed. Press 
the Space Bar to return to the copier menu. 


F4 : 


C-128 USERS ONLY! Video RAM (64K) Toggle ON/OFF. 


Those users that have a C-128D or have installed 
expanded video RAM into their standard jC=12g_ may 
take advantageofthat additionalmemory by 
using this feature. Only eight passes (rather 
that 16) will be required to copy a full disk. 
Do not use this feature unless you are certain 
that you do in fact have the added RAM. 

For those of you that wish to install the 
required 64K RAM, we suggest the 64K Video RAM 
Upgrade available from Software Support 
International. This unit is easily installed and 
requires NO soldering or expertise. Contact Tech 
Support for more details. 
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RAM Expansion Toggle ON/OFF. The Single Data 
Copier will not test for a RAM Expansion unit in 
your cartridge port. When toggled ON, you roust 
roake sure that the RAM Expander (1764 or 1750 
only) is in proper working order and plugged in 
correctly. 

The Fast Data Copier with REU toggled ON 
will react in a similar manner as when toggled 
OFF except, fewer passes will be required. 
(1764/3 passes, 1750/2 passes) 

PikCL J a a fcajG Q BieEi 

With the 1581 Toolkit Main Menu on the screen, 
and the Toolkit disk in the disk drive, select the 
Fast Data Copier option. When prompted, select D for 
(D)ual Data Copier. The disk drive will become active 
and the Dual Data Copier menu will appear on the 
screen. At the top of the screen you will see device 
information for two drives and, below that, the 
copier menu. The menu options beginning at the top 
are: 

COPY DISK : 

After all other menu options have been 
properly set, use this command to begin the copy 
process. 


REBOOT MAIN MENU: 

When you select this command, the 1581 
Toolkit will ask you to place the Toolkit disk 
in the drive bearing the device number from 
which you first loaded the program. After you 
press the Space Bar, the program will reboot. 
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DISK COMMAND: 


Selecting this option gives you direct access 
to the 1581 drive without the headache of using 
the OPEN statement. All standard disk commands 
are available including the ability to change 
partitions. This option acts as any other 
standard DOS wedge. There is no need to type the 
< OPEN 15,8.15." > portion of the command. 

Simply type in the command desired at the 
flashing cursor. For example, to initialize any 
diskette in the current drive, just type in 
< 10 > . To list the directory, use the F1/F3 
keys which are active in this mode (see below). 

SOURCE DRIVE: 

When the cursor bar highlights this feature 
you may press RETURN to toggle through the 
available Source Drives. The drive information 
will be updated at the top of the screen. 

TARGET DRIVE: 

Highlight this feature and press RETURN to 
toggle through the available target drives. The 
drive information will be updated at the top of 
the screen. 

STARTING TRACK: 

If you wish to start copying the disk at some 
other track than track 1 (default), use this 
command. See Single Drive Copier section for 
more information. 

ENDING TRACK: 

If you wish to stop copying the disk at some 
track other than track 80 (default), use this 
option. See Single Drive Copier section for more 
information. 

F1/F3: 


Pressing FI will display the directory of the 
diskette in the Source Drive. Pressing F3 will 
display the directory of the diskette in the 
Target drive. 
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FAST FILE COPIER 
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When presented with the task of transferring the 
program files from disk A to disk B, the Commodore 
user generally selects a file copier to do the job. 
Our Fast File Copier is designed to transfer program 
and sequential files back and forth from a 1541, 
1571, or 1581 drive. We support the true 1571 format 
as well as partitions on the 1581. We have used fast 
disk access routines throughout this utility for 
optimum speed. We're confident that you'll find our 
file copier to be as fast or faster than any other 
file copier on the market. Enjoyl 

As you use this utility, keep in mind a few 
important rules. For one thing, file copiers don't 
usually work well on most copy protected software. 
Even if you make a "clean” copy of your protected 
software using our single drive fast copier, and use 
a parameter to defeat the protection scheme, there is 
still no guarantee that you may copy the files and 
still have a program that works properly. 

Many pieces of commercial software use direct 
disk access to load blocks and sometimes even files 
of data. These programs can only be copied by the 
whole disk copy method. The file copier is only able 
to transfer those files that have valid directory 
entries. Any data not connected to an entry in the 
disk directory will be left behind. Another point 
worth mentioning is that you MUST use a properly 
formatted disk as your destination disk. This disk 
may be freshly formatted, or may have other files 
already on it. For your convenience, we have a 30 
second formatter available within this utility that 
does a full format and verify. 

From the opening menu, select the Fast File 
Copier and press RETURN. The disk drive should start 
up and, in a short time, the Fast File Copier menu 
will appear. 
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%MQ.Drive_Fast File Copier: U 

Because the 1581 options are slightly different w 

than the 1541/71 options, we will identify them in O 
these instructions as such. If no specific drive is 
mentioned, you may assume that all drive types react 
the same. O 


With the Fast File Copier menu on the screen, 
use the cursor U/D key to move the highlight bar O 1 
through the menu selections. Starting at the top of 
the menu, the options are: ^ 

Copy Files: 


This option is selected after all other menu 
options are properly set. See Copy Files section 
below. 

Source Drive: 

Use this option to change the source (original) 
drive device number from 8 to 9,10, or 11. Your 
source drive must be either hard or soft-wired to 
match the change. Your drive type, if any, will 
also be identified in this option. 

Subdirectory of Source (1581): 

Defaults to OFF unless a 1581 disk drive is 
detected as the source drive. This option allows 
you to read into partitions, if any exist on your 
3.5” diskette. With the disk containing the 
partitions in the source drive, and the Highlight 
Bar over the Subdirectory option, hit RETURN. 
Partitions will be displayed, if any, between the 
arrow pointers. Notice that the current directory 
name as well as the previous directory name is 
displayed at the top of the screen. If you wish to 
read into a partition, position the arrow 
pointers, using the Cursor U/D key, on either side 
of the partition name and press RETURN. Again, 
partitions, if any, will be listed on the screen. 
Repeating this process will allow you to read into 
any level of subdirectory or partition you wish. 
If you have gone past a desired partition, use the 
Clear key to return to the Root Directory and 
begin the read process again. To copy files from 
the current partition (listed at the top of the 
screen), hit the Back Arrow key to return to the 
menu. The source drive will remain in the current 
p_axt i t ion unless you access the source 
subdirectory option again. 
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Dest. Drive: 
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Use this option to change the destination (copy) 
drive device number from 8 to 9, 10, or 11. Your 
destination drive must be either hard or soft- 
wired to match the change. Your drive type, if 
any, will be identified in this option. 

Subdirectory of Destination (1581): 


^ See above Subdirectory option. This option will 

only appear if a 1581 disk drive has been selected 
as the destination drive. Please note that you may 
^ save files from one partition to another partition 

on the same disk with proper setup. 
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Save Skew (1541/71): 

The order in which your Commodore disk drive 
saves each sector of data to the diskette is 

called the interleave or Skew. The normal skew 

rate of the 1541 drive is 10. This means that DOS 
begins on, say, sector 0 of a 21 sector track 

(sectors 0 - 20) and writes sector 0 then adds 

ten, writes sector 10, adds ten, writes sector 
twenty, adds ten again to make thirty and 
subtracts the maximum number of sectors allowed in 
that track from the total. In this case it would 
be 20 + 10 = 30 minus 21 = 9, add ten more, and so 
on. The skew is directly related to the speed at 
which the drive is able to send disk data to the 
computer. 

f r “ 2 Normal 154 TTS&s’’' (Disk Operating System J prefers 
a skew of~^en i -~^r^the~sftor^ loading 

time. However, there are fast loader hardware and 
software systems available that will shorten 
loading time considerably. Many fast loaders work 

r at optimum speed when the skew rate is smaller 
than normal. For instance, the 1571 drive in 128 
mode prefers a skew of 6, although any file save 

done in the 64 mode will normally save out at a 

skew of ten - not optimum. When copying files you 
want to use on your 1571 drive (in C-128 mode), 
why not set the skew rate to 6? This will decrease 
load time considerably. Some other commercial fast 
loaders and their optimum skew rates are? Fastload 
Cartridge [10], Mach 5 [10], Super Snapshot with 

the 1541 [5 to 10], and with the 1*571 [5], Warp 

Speed [6], Quick Load [9 to 10], Chip Level 
Design's Burst ROM [5], and Pro DOS an incredible 
[1 to 5 ]! You may want to experiment with your 
favorite fast load utility. 
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Format Dest: 


This option will allow you to initialize or New 
a diskette. You may use a brand new disk or a 
previously used one. Remember, whatever is on that 
disk is going to be erased PERMANENTLY. The drive 
previously set up as the destination drive 
(default is 9) will be the formatting drive. With 
your disk to be Newed in the destination drive, 
select the format option. You will then be asked 
to input the desired disk name (up to 16 
characters) followed by a comma and any two 
character ID, letters or numbers. Press RETURN and 
you will be prompted to double check the disk. Do 
so; when satisfied all is well, hit the Y key for 
Yes. Formatting will take about 30 seconds and 
will automatically return you to the File copier 
menu when finished. If you get a 00, OK, 00,00 
message, then all went well and the destination 
disk has been prepared properly. Please note that 
if the destination drive is a 1571 drive, you will 
be asked whether you want a 1541 or 1571 format. 
If you select the 1571 format, both sides of the 
diskette will be formatted without having to flip 
the diskette over. Follow on screen prompts. 

Softwire Drives: 

See the Softwire Drives section in the Dual 
Drive Fast Data Copier section. Operation is 
identical. 

F1/F3: 

Use these Function keys to read the Source and 
Destination Disk Directories. 
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C-128 USERS ONLY! Video RAM (64K) Toggle ON/OFF. 
Those users that have a C-128D or have installed 
expanded video RAM into their standard C-128 may 
take advantage of that additional memory by using 
this feature. Fewer passes will be required to 
copy a full disk. Do not use this feature unless 
you are certain that you do in fact have the added 
RAM. 

For those of you that wish to install the 
required 64K RAM, we suggest the 64K Video RAM 
Upgrade available from Software Support 
International. This unit is easily installed and 
requires NO soldering or expertise. Contact Tech 
Support for more details. 


F6 : 


RAM Expansion Toggle ON/OFF. The Fast File 
Copier will not test for a RAM Expansion unit in 
your cartridge port. When toggled ON, you must 
make sure that the RAM Expander (1764 or 1750 
only) is in proper working order and plugged in 
correctly. 

The Fast File Copier with REU toggled ON will 
react in a similar manner as when toggled OFF 
except fewer passes will be required to copy the 
data. 


F5: 


Hit this function key to send a disk command to 
either the source or destination drive. This 
feature defaults to the Source drive. Use the # 
key and RETURN to toggle to the destination drive. 
You will be presented with a S> or D>. This is 
your key to the built in DOS Wedge. You may send 
any valid disk command through this wedge. The S> 
and D> is the substitute for the OPEN 15,8,15," 
portion of a disk command. Thus to scratch a file, 
simply type in S >S0:Correct Filename . All other 
disk commands work in the same manner. See your 
disk drive manual for the list of available 
commands. 
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F7: 


Exit to Basic. We have added this option for 
especially for those of you with 1581 drives. You 
may use the partition open commands to read as 
deep into the levels you wish, and then exit to 
BASIC. The last partition opened will still be 
accessible through normal DOS Commands. 

RESTORE: 

The RESTORE key will return the file copier to 
the file copier main menu from any file copier sub 
screen. If a disk drive is active, you may have to 
turn it off and on again to reset it. Please note 
that stopping a copy during disk access may ruin 
the data on the destination disk. Also, before 
shutting the drives down, open the drive doors to 
prevent possible damage to the source diskette. 

Copy Files: 

After all other copy parameters have been set 
and your destination disk is properly prepared, 
place a write protect tab on your original 
diskette and select the Copy Files option. The 
directory of the source disk will be read and will 
appear on the screen. Using the cursor U/D key, 
scroll through the list of directory files. Your 
options are: 

Space Bar: Select the file indicated by the 
pointers. The pointers will automatically move 
down one file after selection. 

A: Toggle Alls You may automatically set all files 
to be copied by pressing A. Note that all files 
are highlighted. The Space Bar will now act as an 
un-highlighter. 
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C: Copy Files: Don't press C until you are done 
selecting all files for copying and both the 
source and destination disks are in their proper 
drives. The source drive will be read and the data 
will be transferred to the destination drive. If, 
as the destination BAM is being written out, the 
copier detects a duplicate file name being placed 
on the disk, you will be prompted for a new name 
for that file. Input up to sixteen characters. 
Please note that the marker lines on the left side 
of the File read-write screen represent about 10 
sectors each. This is to be used as a rough 
indicator only. Don't disturb the disk drives 
until the main file copier menu reappears. 

D: Delete Files: After selecting files, you may 
delete or scratch them from the directory by 
pressing D. You will be asked if you are sure— 
Yes or No. If you choose Yes, you will be asked if 
you would like to confirm each file before it is 
deleted. We suggest you respond Yes as a No 
response allows no turning back. Again, be careful 
with this option as the files can only be 
recovered by a skillful "disk surgeon". 


F8: 


Reboot main Menu. Place the 1581 Toolkit master 
disk in the drive and hit F8. 

The main menu will reboot. 

Single Drive Fast File Copier; 

Our single drive file copier operates exactly 
the same as the dual drive version. To use the Fast 
File Copier with one drive, just leave the source and 
destination device numbers set at the default 
settings of 8, or set both of them to whatever device 
number you are using. You will be prompted to insert 
the source and then the destination disks numerous 
times. Just continue the disk swaps until the copy is 
completed and the main file copier menu reappears. 

DIRECTORY EDITOR 

A Directory Editor is a tool that allows you to 
modify the directory of almost any unprotected disk. 
Our Directory Editor lets you sort, alphabetize, 
rename, lock and unlock files. It also allows you to 
insert file separators which add readability to your 
directories. We've even included partition support. 
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From the 1581 Toolkit Main Menu, select the 
Directory Editor option. Make sure the 1581 Toolkit 
disk is in the drive and press RETURN. After some 
disk access, the Directory Editor Main Menu will 
appear. The available options are: 

READ DIRECTORY: 

This command will read the directory of the 
diskette in the current drive which is listed at 
the top of the menu screen. The root or main 
directory will be read into memory unless the 
drive has been left in partition mode. When the 
directory has been read, it is placed into the 
edit buffer until a new directory is read. This 
means you may edit the same directory without 
having to re-read it. 


EDIT DIRECTORY: 

Selecting this command will take you into the 
Directory Editor. The commands for the Directory 
Editor are explained below under the heading 
Directory Editor Commands . 

NEW DRIVE: 

With this option, you can select one drive 
out of a possible of four 1581 disk drives. Device 
numbers available are 8, 9, 10 and 11. 

REBOOT MAIN MENU: 

When you select this command, the 1581 
Toolkit will ask you to place the Toolkit disk in 
the drive bearing the device number from which you 

first loaded the progr a m . After you press the 

Space Bar, the program will re-boot. 

DISK COMMAND: 

This option gives you direct access to the 
1581 drive without the headache of using the OPEN 
statement. All standard disk commands are 
available, including the ability to change 
partitions. This option acts as any other standard 
DOS wedge. There is no need to type the 
< OPEN 15.8.15. 11 > portion of the command. Simply 
type in the command desired at the flashing 
cursor. For example, to initialize any diskette in 
the current drive, just type in < 10 > . To 

initialize a partition or sub-partition, use the / 
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command. As an example, let's say you have a 
partition on the disk called ' PART 1 '. First, 
select the DISK COMMAND option from the menu. 
You'll then prompted with "Command?". At this 
point type in < /PART 1 > and press RETURN. You 
have now initialized the partition called ' PART 1 
'. Any disk access now concerns itself solely with 
that partition. To return to the root directory, 
simply type in < / > at the "Command?" prompt and 
press RETURN. To list the directory, use the F1/F3 
keys which are active in this mode. 

F1/F3: 


Pressing F1/F3 will display a listing of the 
directory or partition of the diskette in the 
current drive. Pressing the Space Bar while the 
directory is scrolling will stop the scroll. 
Pressing the Space Bar again will continue the 
listing. Use the RUN/STOP key to abort the 

listing. 

Pi re<?t QEy 

Once you have read a directory and selected the 
EDIT DIRECTORY command, the Toolkit will switch to 
the editing screen. 

Edit Changes: 

At the top of the screen, you will see 

information about the disk and the file currently 

pointed to by the flashing arrows in the Input 
Buffer. Use the U/D Cursor to move the arrows to the 
filename you wish to edit. Now press the E key for 
Edit and type in your changes. The U/D or RETURN keys 
will allow you select the following items. 

Disk Name: You may rename the disk with a name up 
to 16 characters long. When you have finished, 

press the U/D Cursor key to move to the next 
selection. 

ID: A standard disk ID consists of five bytes. The 
first two are the ID bytes you declared when you 
formatted the disk. The fourth and fifth bytes are 
CBM DOS ID bytes. These bytes, plus the space 
between them, can be replaced with any 
alphanumeric character (five characters). 
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File Name: This option allows you to rename a file 
with a name up to 16 characters long. Please Note: 
DO NOT use the characters * , ? or " in Disk 
Names or File Names. Using these characters WILL 
cause problems accessing files that include them. 

File Type: You may change the file type by using 
this option. Select the new file type by using the 
L/R Cursor key. Please keep in mind that this 
change is risky, because you can't really change a 
RELative file into a SEQuential file by changing 
its' type. In fact, some files may not load 
correctly if you change their type. Experiment on 
a work disk to verify that such files will still 
work properly. 

Status: You may Lock or Unlock a file with this 
selection. When a file is Locked you cannot 
scratch the file through normal drive commands. 
However, if you format the disk, the file will be 
lost. 

Left Arrow: The Left Arrow key (not the cursor 
key) will allow you to abort the Edit Changes 
mode. 

Buflter-Edit Commands: 

In the lower part of the screen you will see two 
buffers. When a directory is read, it is placed into 
the Input Buffer. All entries must be moved to the 
output buffer in order to re-write the new directory. 
You may scroll the flashing arrows through the 
listing using the U/D Cursor key. The R/L Cursor key 
allows you to select the ACTIVE buffer (you may edit 
in either buffer). The commands available in the 
ACTIVE buffer are as follows: 

RETURN: If you place the flashing arrows beside a 
partition name (indicated by the File Type 'SUB' 
in the upper part of the screen) and press RETURN, 
the contents of that partition will be read into 
the Input Buffer. There is no limit to the depths 
which the Toolkit will sink to display a sub¬ 
partition. In order to return to a previous 
partition, or to the root directory, you must 
press RESTORE to return to the Editor Main Menu 
and use the DISK COMMAND option to initialize the 
disk to the root directory < / >. Use the READ 
DIRECTORY option and the RETURN key as before to 
return to the desired partition. 
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Space Bar: The Space Bar allows you to toggle the 
selection status of a file. A file is considered 
9 selected' if it is highlighted. After toggling 
the file, the flashing arrows will move down to 
the next file entry. You may continue using the 
Space Bar to toggle multiple files, or use the 
cursor keys to move the arrows elsewhere. Please 
note that you may set up multiple blocks of 
highlighted file entries. These groups will be 
treated as if they were all in the same block. 

HONE: Use the Home key to quickly return to the first 
entry in the file listing. 

A: This option will toggle All selections to their 
opposite status. For example, if you highlight one 
file with the Space Bar and then press All, that 
one file will no longer be highlighted but the 
other files in the directory will. To reverse the 
effect, press All once more. 

S: This will Sort all the files in the ACTIVE buffer 
that are highlighted. You will be prompted with 
"Are you sure?”. Answer Yes or No. The sorted 
block will be placed in the same position as it 
was previously. The difference being that the 
files are now in numerical and alphabetical order. 

M: To move the highlighted area(s) to the other 
buffer, place the arrows to the position just 
below where you want the block inserted and press 
M to Move it. If the arrows are not placed in the 
opposite buffer before the Move command is used, 
the block will move by default to the bottom of 
the opposite buffer. 

D: You may insert Dividing lines into the directory 
to separate a file or groups of files. To do so, 
place the flashing arrows just below the spot you 
wish to insert the dotted line and press D to 
Divide. This divider is cosmetic and will not use 
any real disk space. 

W: Once you have made the changes to the directory, 
press W to Write the changes to the disk. 
Remember, ALL entries must be moved to the output 
buffer. You will be asked "Are you sure?", think 
about it, then answer Yes or No. If you answered 
Yes, your modified directory will be written to 
the disk. If you answered No, you will be returned 
to the edit mode. 
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RESTORE: Pressing the RESTORE key will return you to 
the Directory Editor Main Menu. Your work in the 
Edit Buffers will not be altered unless you use 
the READ DIRECTORY command again. 

If, before using the READ DIRECTORY command again, 
you decide you need to make one last change to the 
previous directory, you may select EDIT DIRECTORY 
again, make the change and re-Write the directory 
again. 


TRACK & SECTOR EDITOR 

We have created this utility for those of you 
who have the desire to examine the data on your 3.5” 
diskettes in their track and sector / data block 
format. We have included the ability to modify 
sectors and print Hex/Disassemble listings. We feel 
that you'll find our Track and Sector Editor to be 
quite easy to use and that it allows a full range of 
commands. 

We cannot, in the scope of these instructions, 
teach you the 1581 DOS format. For that information, 
we refer you to the 1581 DOS Reference Guide included 
in this package. It is the best manual of its kind on 
the market. We want to thank David Martin for his 
efforts in producing such a comprehensive guide. 

As always, be careful with this utility as 
irreversible damage can be done to the data on your 
work disk. For your protection, we suggest always 
working with a backup of the disk presently under 
examination and modification. 

From the Toolkit Main Menu, select the Track/Sec 
Editor and press RETURN. When the Track and Sector 
Editor Main Menu appears, you will have the following 
options: 

EDIT DISKETTE: 

Position the Highlight Bar over the EDIT 
DISKETTE option and press RETURN. The Editor 
screen will appear and prompt you with the 
flashing cursor for the Track you wish to read (in 
Decimal). Although it will default to track 40, 
the directory track, you may input tracks 1 
through 80, and press RETURN. Next, the cursor 
will move to the Sector input. Although it 
defaults to 00, you may enter any sector from 00 
through 39, and press RETURN. 
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At this point, the desired sector will be 
read in and displayed on the screen. You have many 
command keys available to you. 

[ ] - Change Byte: Use The Space Bar to change 

value of the byte indicated by the flashing 
cursor. You input in decimal or use the Down 
Cursor key to toggle to Hex input. Hake your 
change and press RETURN to lock it in. 

[+] - Scan Forward: Use this key to scan forward 
one sector at a time. Notice that at sector 39 it 
will wrap to the next track, sector 00. 

[N] - Next Track: Use this key to scan forward one 
track at a time. Notice that at track 80 it will 
wrap to track 01. 

[J] - Jump To Link: This command has two different 
operating modes. In track 40, the directory track, 
you may use it to jump to the first link of any 
valid program file. Simply place the flashing 
cursor over the track link and press J. You will 
be taken to that track and sector. 

When you are in any other track, pressing J will 
take you to the next file link, if any, indicated 
by the first two positions in the sector. 

[T] - New Track: Hit T to return the flashing 
cursor to the Track input window. Input tracks 01 
through 80. After the track has been selected, you 
may input a new sector or press RETURN to default 
to the current setting. 

[W] - Write Sector: When all modifications have 
been made to the current sector, hit W to rewrite 
that sector to the disk. You will be prompted with 
•'Are You Sure?”. Answer Yes or No. 

[D] - Disassemble: Hit D to enter the Disassemble 
Mode. The current sector under examination will be 
displayed at the bottom of the screen in 
disassembly code. Please note that the top of the 
screen still contains the sector map and may be 
used for position reference. All sectors read into 
the disassemble buffer are set at $7D00. This is 
only a reference and not an indication of that 
sector's true address if it were found in memory. 

Space Bar: Pressing the Space Bar will move the 
cursor into the operand field of the current 
line and allow you to modify the opcode 
and/or operand. 
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RETURN: After modification, press RETURN. If the 
change made to the line was a valid 
opcode/operand combination, the new code will 
be locked in, and the cursor will move to the 
beginning of the next opcode field. If the 
change made was not a valid opcode/operand 
combination, the original data is not changed 
and the cursor returns to the beginning of 
the line. 

W: To Write the modified block to the disk, 
press W. 

Left Arrow: Pressing the Left Arrow key (not the 
Left Cursor key) will escape to the previous 
screen. 

P: Press P to dump the current buffer to any 
printer capable of emulating the Commodore 
801/1525 printer. 

[A] - ASCII Node: Use the A key to input text 

directly from the keyboard to the data display screen 
starting at the flashing cursor. Only alphanumeric 
input is allowed. You may use the Control/T keys to 
backup the cursor while in this mode. When all 
changes are made, hit RETURN to escape. If your 
changes are unacceptable, re-read the sector by 
hitting S and RETURN to bring up the sector again. 

[-] - Scan Back: Use this key to scan backwards one 
sector at a time. Notice that at sector 00 it will 
wrap to the previous track, sector 39. 

[M] - Previous Track: Use this key to scan backwards 
one track at a time. Notice that at track 01 it will 
wrap to track 80. 

[K] - Previous Link: Use this option to reverse read 
the links that were just read by the Jump command. 

[S] - New Sector: Hit S to return the flashing 

cursor to the Sector input window. Input Sectors 00 
through 39. 

[H] - Hex Node: Hit H to enter the Hex Mode. The 
current sector under examination will be displayed at 
the bottom of the screen in memory map format (Hex 
map on the left, ASCII map on the right). Please note 
that the top of the screen still contains the sector 
map and may be used for position reference. All 
sectors read into the Hex buffer are set at $7D00. 
This is only a reference and not an indication of 
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that sector's true address if it were found in 
memory. 

Cursor Keys: In this mode, the Cursor Keys move 
the cursor as normal. 

W: Press W to Write the current block to disk. 

Left Arrow: Pressing the Left Arrow key (not the 
Left Cursor key) will escape to the previous 
screen• 

P: Press P to dump the current buffer to any 
printer capable of emulating the Commodore 
801/1525 printer. 

Home: From the main edit screen, use the Home 
key to return the flashing cursor to position 
00 . 


RETURN: From the main edit screen, use the 
RETURN key to position the flashing cursor to 
the next line down, first position. When on 
the bottom line, the flashing cursor will 
wrap to the top line. 

Cursor U/D and R/L: Use these keys to move the 
flashing cursor on any command screen. They 
work as normal. 


[<-] - Main Menu: Use the Back Arrow key to escape 

from any command screen to the previous screen. 

RESTORE: Return to Track & Sector Editor Main Menu. 

The other Main Menu commands are: 

NEW DRIVE: 

With this option, you can select one drive 
out of a possible of four 1581 disk drives. Device 
numbers available are 8, 9, 10 and 11. 

REBOOT MAIN MENU: 

When you select this command, the 1581 
Toolkit will ask you to place the Toolkit disk in 
the drive bearing the device number from which you 

first_Iflfl fl fidLJAs pro gra m * After you press the 

Space Bar, the program will reboot. 
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DISK COMMAND: 


This option gives you direct access to the 
1581 drive without the headache of using the OPEN 
statement. All standard disk commands are 
available including the ability to change 
partitions. This option acts as any other standard 
DOS wedge. There is no need to type the 
< OPEN 15.8.15.” > portion of the command. Simply 
type in the command desired at the flashing 
cursor. For example, to initialize any diskette in 
the current drive, just type in < 10 > . To 
initialize a partition or sub-partition, use the / 
command. As an example, let's say you have a 
partition on the disk called ' PART 1 '. First, 
select the DISK COMMAND option from the menu. 
You'll then prompted with "Command?”. At this 
point type in < /PART 1 > and press RETURN. You 
have now initialized the partition called ' PART 1 
'. Any disk access now concerns itself solely with 
that partition. To return to the root directory, 
simply type in < / > at the "Command?" prompt and 
press RETURN. To list the directory, use the F1/F3 
keys which are active in this mode. 

F1/F3: 


Pressing F1/F3 will display a listing of the 
directory or partition of the diskette in the 
current drive. Pressing the Space Bar while the 
directory is scrolling will stop the scroll. 
Pressing the Space Bar again will continue the 
listing. Use the RUN/STOP key to abort the 
listing. 


FILE TRACK & SECTOR TRACER 

The File Track & Sector Tracer allows you to 
conveniently examine, modify or repair a file 
directly from a disk. Not only does it show how the 
file is laid out on a disk, but it also gives you the 
option of seeing the data in two different forms. 

From the 1581 Toolkit Main Menu, select the File 
T & S Tracer option. Make sure the 1581 Toolkit disk 
is in the drive and press RETURN. After some disk 
access, the File Tracer Main Menu will appear. The 
menu options are: 
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CHOOSE A FILE: 
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Display Node: 

When you have selected this command, you will 
be prompted to place the disk with the file you 
wish to trace into the drive. Press the Space Bar, 
and the program will display the directory of the 
disk in a window. The window will display 
directory files and partitions, if any exist. 
Partitions will be flagged as SUB, while standard 
files will be displayed along with their sector 
lengths. In order to read into a partition (SUB), 
simply place the Highlight Bar over it and press 
RETURN. The directory of that partition, if any, 
will be displayed as before. 

Please note : In order to return to a 
previous partition or to the root directory, you 
must press RESTORE to return to the Main Menu and 
use the DISK COMMAND option to initialize the disk 
to the root directory < / >. Use the CHOOSE A 
FILE option and the RETURN key as before to return 
to the desired partition. 

Choose a file, using the U/D Cursor key and 
press RETURN. The filename and the number of 
blocks being linked by the Tracer will be 
displayed. When the linking is complete, you will 
be prompted to press the Space Bar. 

Although the File T & S Tracer was made 
specifically for Program files, we have made 
allowances for Sequential files. Sequential files 
will always default to address $1000 even though 
they really have no load address. Use the 
addressing for reference only. 

The File Tracer program will display a Track 
and Sector grid. The physical location of the file 
is shown as a series of yellow blocks on the grid. 
The beginning of the file is marked by a flashing 
black cursor. The current track and sector 
position (in Decimal) of the cursor is displayed 
at the top of the screen. Also shown is the actual 
memory address (in Hex) of the indicated block. 

Pressing the RESTORE key at any time will 
return you to the File Tracer Main Menu. 

Edit Mode: 
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Use the U/D Cursor key to move the flashing 
pointer back and forth through the sectors. When 
you press the DOWN Cursor key, notice that the 
flashing cursor moves forward through the file 
sectors in the order that they are linked 
together. The L/R Cursor key will move the 

flashing cursor eight blocks at a time. 

Press the Space Bar to examine the data in 
the block currently marked by the flashing cursor. 
The data will be loaded from the disk and 

displayed in disassembly format. If you wish to 
see the data in the Hex/Ascii format press M for 
Mode, which will toggle between the two displays. 
Whichever mode you choose will remain active until 
you change it, even if you decide to trace another 
file. Let's examine the editing commands for each 
mode: 

DISASSEMBLY MODE: 

Space Bar: Pressing the Space Bar will move the 
cursor into the operand field of the current 
line and allow you to modify the opcode 
and/or operand. 

RETURN: After modification, press RETURN. If the 
change made to the line was a valid 
opcode/operand combination, the new code will 
be locked in and the cursor will move to the 
beginning of the next opcode field. If the 
change made was not a valid opcode/operand 
combination, the original data is not changed 
and the cursor returns to the beginning of 
the line. 

HOME: To return to the beginning of the block, 
press HOME when the cursor is to the left of 
the address column. 

J: When the cursor is to the left of the address 
column, press J to Jump to the next block in 
the file. 

W: To Write the modified block to the disk, 
press W. Note: If you do not write the 
modified block to the disk before you leave 
the current screen, all modifications made to 
that block will be lost. 

Left Arrow: Pressing the Left Arrow key (not the 
Left Cursor key) will re-display the Track 
and Sector grid. 
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HEX/ASCII MODE; 
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Cursor Keys: In this mode, the Cursor Keys move 
the cursor as normal. 

HOME: Press HOME at any time to return to the 
beginning of the block. 

J: Press J to Jump to the beginning of the next 
block in the file. 

W: Press W to Write the current block to disk. 

Left Arrow: Pressing the Left Arrow key (not the 
Left Cursor key) will re-display the Track 
and Sector grid. 


Other Main Menu Options: 

EDIT FILE: 

Re-displays the Track and Sector grid and 
allows editing of the currently chosen file. 

NEW DRIVE: 

With this option, you can select one drive 
out of a possible of four 1581 disk drives. Device 
numbers available are 8, 9, 10 and 11. 

REBOOT MAIN MENU: 

When you select this command, the 1581 
Toolkit will ask you to place the Toolkit disk in 
the drive bearing the device number fro m wh i ch. , yw 

first_LP-flAe d t hs .pro gram . After you press the 

Space Bar, the program will reboot. 
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DISK COMMAND: 


This option gives you direct access to the 
1581 drive without the headache of using the OPEN 
statement. All standard disk commands are 
available including the ability to change 
partitions. This option acts as any other standard 
DOS wedge. There is no need to type the 
< OPEN 15.8.15." > portion of the command. Simply 
type in the command desired at the flashing 
cursor. For example, to initialize any diskette in 
the current drive, just type in < 10 > . To 

initialize a partition or sub-partition, use the / 
command. As an example, let's say you have a 
partition on the disk called ' PART 1 '. First, 
select the DISK COMMAND option from the menu. 
You'll then prompted with ••Command?”. At this 
point type in < /PART 1 > and press RETURN. You 
have now initialized the partition called ' PART 1 
'. Any disk access now concerns itself solely with 
that partition. To return to the root directory, 
simply type in < / > at the ••Command?” prompt and 
press RETURN. To list the directory, use the F1/F3 
keys which are active in this mode. 

F1/F3: 


Pressing F1/F3 will display a listing of the 
directory or partition of the diskette in the 
current drive. Pressing the Space Bar while the 
directory is scrolling will stop the scroll. 
Pressing the Space Bar again will continue the 
listing. Use the RUN/STOP key to abort the 
listing. 

PATTERN SEARCHER 

We created the Fast Data Scanner to help us find 
bytes on a diskette that we have found in memory 
after examination of a program. The uses are endless. 
We have even used it to aid in the recovery of a 
short New, and search for repeating patterns. 

From the Toolkit Main Menu, select the Pattern 
Searcher and press RETURN. When the Pattern Searcher 
Main Menu appears, the following are your options. 
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ENTER PATTERN : 
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Use this option to enter data you wish to 
scan the disk for. At the prompt, you may enter 
the bytes you are trying to locate in any of three 
forms. HEX, Decimal, or ASCII will be acceptable. 
You are limited to two lines of input. An 
incorrect input will not be accepted. 

Enter HEX data as : $8D,$53,$22 (Notice the "$" 
and the "," placements.) 

Enter Decimal Data as : 200,255,36 (Notice the "," 
placements.) 

Enter ASCII data as : "welcome to" (Notice the 
quotes around the string.) 

Enter Combinations of all three such as : "welcome 
to",$8D,$53,$22,200,255,36 

When all data has been entered, hit RETURN or 
RESTORE and the Pattern Searcher Main Menu will 
reappear. The data information you typed in will 
be retained for future reference within the ENTER 
PATTERN screen. 

SCAN DISK: 
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After setting all other options, begin a scan 
of the diskette currently in the disk drive. 
You'll be prompted to insert the disk to scan and 
press Space Bar. As the disk is scanned, you will 
be informed of the current track being read and 
the number of matches found on the disk, up to 255 
(which is the maximum holding buffer). If more 
than 255 matches are suspected, break the disk 
scan into several smaller segments using the 
Start/End Track settings. To stop the scan and 
reset the drives, press RESTORE. If the scan is 
aborted, you will have to re-scan before you can 
use the EDIT MATCHES option (see below). 
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If no matches were found during the scan 
process, you will be prompted to hit Space Bar, 
which will return you to the Pattern Searcher Main 
Menu. If matches were found during the scan, 
you'll be prompted to hit the Space Bar to enter 
the EDIT MATCHES screen. Please Note: The EDIT 
MATCHES screen is held in a buffer until it is 
replaced by a new scan. See EDIT MATCHES option 
below. The sector counter is along the left side 
of the screen and the track counter is along the 
bottom. A flashing cursor will appear at the 
position of the first data pattern match. Please 
note that all sectors containing matches will 
appear on the screen as highlighted blocks. 

Other active keys in this mode are: 

Fl/3/5/7: These function keys are used in a 
similar manner as the Cursor keys. PI and F3 move 
the flashing cursor vertically, and the F5 and F7 
keys move it horizontally. 

Cursor U/D/R/L: Use these keys to position the 
flashing cursor over any sector you would like to 
examine further. 

Space Bar: Read ANY sector into memory for editing 
or viewing purposes. The sector indicated by the 
flashing cursor will be read in. Keep in mind that 
highlighted blocks contain your matches. At this 
point, the sector will be read into a buffer at 
address $7F00, and will be displayed in 
disassemble mode. If you are reading a sector 
containing a pattern match, your matches will be 
indicated as highlighted areas. You may use the 
Cursor U/D and R/L keys to position the cursor to 
the first address to modify. You may make changes 
by hitting the Space Bar and typing in your 
changes in mnemonics. Be sure to use proper 
spacing. Hit RETURN after each change. A bad 
instruction will exit the edit mode. 

To view the same sector in Hex/ASCII mode, 
hit the M for Mode key and the memory map will 
appear. You may use the Cursor U/D and R/L keys to 
position the cursor to the first byte to modify. 
Make any desired changes in HEX. After all changes 
are complete, use the W key to re-Write the 
sector. Use the Left Arrow key (ESC) to exit to 
the previous screen. You may select a new sector 
or return to the Main Menu by hitting RESTORE. 
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EDIT HATCHES: 


n 

n 

r\ 

n 

rs 

n 

n 

n 

n 

o 

n 

n 

o 

n 

o 

o 

r\ 

o 

n 

r> 

r> 

r\ 


r*) 
r ^ 

n 

n 

n 

rs 

n 

r*\ 

r*\ 

n 

n 


Re-enter the Track and Sector Map after 
a RESTORE or Escape has occurred from the Edit 
Mode. 

NEW DRIVE: 

With this option, you can select one drive 
out of a possible of four 1581 disk drives. Device 
numbers available are 8, 9, 10 and 11. 

REBOOT MAIN MENU: 

When you select this command, the 1581 
Toolkit will ask you to place the Toolkit disk in 
the drive bearing the device number from which you 

£±X $. t _ loaded the program . After you press the 

Space Bar, the program will reboot. 

DISK COMMAND: 

This option gives you direct access to the 
1581 drive without the headache of using the OPEN 
statement. All standard disk commands are 
available including the ability to change 
partitions. This option acts as any other standard 
DOS wedge. There is no need to type the 
< OPEN 15.8.15." > portion of the command. Simply 
type in the command desired at the flashing 
cursor. For example, to initialize any diskette in 
the current drive, just type in < 10 > . To 

initialize a partition or sub-partition, use the 
/ command. As an example, let's say you have a 
partition on the disk called ' PART 1 '. First, 
select the DISK COMMAND option from the menu. 
You'll then prompted with ••Command?". At this 
point type in < /PART 1 > and press RETURN. You 
have now initialized the partition called ' PART 1 
'. Any disk access now concerns itself solely with 
that partition. To return to the root directory, 
simply type in < / > at the "Command?" prompt and 
press RETURN. To list the directory, use the F1/F3 
keys which are active in this mode. 

STARTING TRACK: 

Place the Highlight Bar on this option and 
press RETURN. The Starting Track defaults to 01, 
but any number from 01 to 80 may be entered at the 
flashing cursor. Press RETURN to lock in your 
change. 
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ENDING TRACK: 


Place the Highlight Bar on this option and 
press RETURN. The Ending Track defaults to 80, but 
any number from 01 to 80 may be entered at the 
flashing cursor. Press RETURN to lock in your 
change. 

F1/F3: 


Pressing F1/F3 will display directory of the 
diskette in the current drive. Pressing the Space 
Bar while the directory is scrolling will stop the 
scroll. Pressing the Space Bar again will continue 
the listing. Use the RUN/STOP key to abort the 
listing. 


PARTITION CREATOR 

One look at the Partition OPEN command in 
Commodore's 1581 Disk Drive Owners Manual is enough 
to make the average user forget partitions forever. 
The Open Partitions utility on the Demo disk is only 
slightly better. 

With this in mind, you will know why we are 
especially proud of our Partition Creator. Once you 
use it, you'll be hooked. Opening, closing, creating 
and deleting partitions will not only be easy but, in 
fact - FUN. 

From the Toolkit Main Menu, select and boot the 
Partition Creator. When the Partition Creator Main 
Menu appears, your options are: 

READ DIRECTORY: 

Read the directory of the disk in the drive 
in order to use the SHOW PARTITIONS option. 
Returns to the Partition Creator Main Menu after 
read is completed. 

SHOW PARTITIONS: 

After a disk is read using the READ DIRECTORY 
option, use this option to display the results. 
You'll be presented with a display representing 
your 3.5” diskette. From the top of the screen, 
the display shows the following components: 

Name : The name of the current directory (root or 
partition). 
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ID : The ID number of the current directory (root 
or partition). 

Track Marker s This is a visual representation of 
the 80 tracks on your 3.5" diskette. You may use 
the Cursor R/L keys to move the "double high" 
flashing cursor along the marker back and forth. 
The F1/F3 keys toggle the display from tracks 
1-40 and 41-80. The J key allows you to fast 
Jump from partition to partition, if any. This 
jump will be in accordance with the Bam setup. 

For ease of use, the Track Marker has been color 
coded. Yellow : Open usable tracks. Red : These 
tracks are either reserved for DOS use only or are 
already in use by current files or partitions on 
the disk. Blue : These tracks represent a 
partition at the current level. Black : Position 
of movable cursor. 

Partition Tree Markers : These will be "hanging" 
down from the Track Markers on the location of the 
first track of that partition. 

Level Marker : Will indicate either the Root 
Directory (main disk directory) or how many sub¬ 
directory Levels you have descended into. 

Command Keys: The following keys are the main 
inputs used to manipulate the partitions on your 
diskette regardless of the level you're working 
in. 

C - Create : When the C key is hit, the cursor 
will move automatically to the first available 
track that a partition could be created on. You 
will be prompted to choose the desired Starting 
Track. Use the Cursor R/L key to position to the 
desired track and press Space Bar. If your choice 
is not "legal" you will be notified of such and a 
press of the Space Bar again will allow you to 
select a new position. Once a "legal" position is 
accepted, you will be prompted for a partition 
name. You may use up to 16 alphanumeric 
characters, and hit RETURN. Use the Cursor key to 
select the number of tracks you wish the partition 
to reside on, and hit Space Bar. The screen will 
blank as the partition is being created and, upon 
completion, the new updated screen will appear. 
Notice the Level has changed to reflect the new 
depth• 


1581 Toolkit v2 


-33- 


< c) 1989 H.O.S. INC. 



D - Delete : Any partition may be deleted by 
positioning the Cursor on the blue portion of the 
Track Marker representing the desired partition. 
Hit D, and you will be asked for a Yes or Mo. 

R - Read : With the Cursor on a blue portion of 
the Track Marker, hit R to Read that partition. 
Notice that the screen will change to reflect the 
current Level. 

Other command keys available are: 

Back Arrow : Allows you to back out of partitions 
one level at a time. 

RESTORE : Escapes to Partition Creator Main Menu. 
Please note that the disk drive has been left in 
the sub-directory that it was in when you escaped. 
Using the SHOW PARTITION option at this point will 
re-display the level as you left it. 

The other Main Menu commands are: 

NEW DRIVE: 

With this option, you can select one drive 
out of a possible of four 1581 disk drives. Device 
numbers available are 8, 9, 10 and 11. 

REBOOT MAIN MENU: 

When you select this command, the 1581 
Toolkit will ask you to place the Toolkit disk in 
the drive bearing the device number from which you 
fiKS- t lead e d . th e .pr aggaro . After you press the 
Space Bar, the program will reboot. 

EXIT TO BASIC: 

This command allows you to go directly to 
BASIC and use the partition or sub-directory that 
is currently active. To use any Toolkit utility 
again, you must reboot the 1581 Toolkit disk. 

DISK COMMAND: 

This option gives you direct access to the 
1581 drive without the headache of using the OPEN 
statement. All standard disk commands are 
available, including the ability to change 
partitions. This option acts as any other standard 
DOS wedge. There is no need to type the 
< OPEN 15.8.15.” > portion of the command. Simply 
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type in the command desired at the flashing 
cursor. For example, to initialize any diskette in 
the current drive, just type in < 10 > . To list 
the directory, use the F1/F3 keys which are active 
in this mode. 

F1/F3: 


Pressing F1/F3 will display a listing of the 
directory or partition of the diskette in the 
current drive. Pressing the Space Bar while the 
directory is scrolling will stop the scroll. 
Pressing the Space Bar again will continue the 
listing. Use the RUN/STOP key to abort the 
listing. 


FAST FORMATTER 

This module is used to format 1581 diskettes 
faster than normal dos formatting allows. Our 
Formatter does a full verify of the format. By 
selecting the Starting and Ending tracks you can do a 
Partial Format for custom format jobs. Try 
experimenting around with this option to see what you 
can come up with, but remember that track 40 must be 
formatted for the directory track! Experiment only on 
unimportant work disks. As always, remember that any 
format (not short new) is irreversible. Once the 
process has begun, there is no way to recover the 
data that may have been on the disk. 

From the Toolkit Main Menu, select and load the 
Fast Formatter option. When the menu appears, your 
options will be: 

STANDARD FORMAT: 

Select this option to start the fast 
formatting process. You will be prompted for the 
disk name. Type in the disk name using up to 16 
characters, and press RETURN. Next you will be 
prompted for the disk ID. Again type in two 
alphanumeric characters and press RETURN. At this 
point, make sure the disk you wish to format is in 
the drive and press Space Bar. After the format is 
complete, you'll be prompted to press Space Bar, 
and the program will then return to the Fast 
Formatter Main Menu. 
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You'll find that our Fast Formatter is 
substantially faster than Commodore's standard 
format routine. It is approximately 30% faster, 
yet just as reliable. 

PARTIAL FORMAT: 

Select this option after setting the STARTING 
TRACK and ENDING TRACK. You will be prompted to 
insert a diskette in the drive and press Space 
Bar. Follow on screen directions. 

NEW DRIVE: 

With this option, you can select one drive 
out of a possible of four 1581 disk drives. Device 
numbers available are 8, 9, 10 and 11. 

REBOOT MAIN MENU: 

When you select this command, the 1581 
Toolkit will ask you to place the Toolkit disk in 
the drive bearing the device number from which you 

first_ loaded the program . After you press the 

Space Bar, the program will reboot. 

DISK COMMAND: 

This option gives you direct access to the 
1581 drive without the headache of using the OPEN 
statement. All standard disk commands are 
available, including the ability to change 
partitions. This option acts as any other standard 
DOS wedge. There is no need to type the 
< OPEN 15,8,15." > portion of the command. Simply 
type in the desired command at the flashing 
cursor. For example, to initialize any diskette in 
the current drive, just type in < 10 > . To 

initialize a partition or sub-partition, use the 
/ command. As an example, let's say you have a 
partition on the disk called ' PART 1 '. First, 
select the DISK COMMAND option from the menu. 
You'll then prompted with "Command?”. At this 
point type in < /PART 1 > and press RETURN. You 
have now initialized the partition called ' PART 1 
'. Any disk access now concerns itself solely with 
that partition. To return to the root directory, 
simply type in < / > at the "Command?" prompt and 
press RETURN. To list the directory, use the F1/F3 
keys which are active in this mode. 

STARTING TRACK: 
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n 

^ Place the Highlight Bar on this option and 

^ press RETURN. The Starting Track defaults to 01, 

but any number from 01 to 80 may be entered at the 
^ flashing cursor. Press RETURN to lock in your 

change. 

^ ENDING TRACK: 
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Place the Highlight Bar on this option and 
press RETURN. The Ending Track defaults to 80, but 
any number from 01 to 80 may be entered at the 
flashing cursor. Press RETURN to lock in your 
change. 

F1/F3: 
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Pressing F1/F3 will display a listing of the 
directory of the diskette in the current drive. 
Pressing the Space Bar while the directory is 
scrolling will stop the scroll. Pressing the Space 
Bar again will continue the listing. Use the 
RUN/STOP key to abort the listing. 

ERROR SCANNER 
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We created the Error Scanner to determine 
whether or not a disk has DOS errors on it. This 

utility will give you a visual representation of the 
integrity of the data on your work disks. We have 
built in some handy features, such as a data usage 
display and printer dump. 

From the Toolkit Main Menu, select the Error 
Scanner and press RETURN. You'll be presented with 
the following options: 

SCAN DISK: 

After all other options have been set up, 
select this option to begin the scan. After 

selecting the SCAN DISK option, you will be 
prompted to insert the disk that you want to scan 
and press Space Bar. To stop the scanning process, 
press the RESTORE key. Please note that if the 

scan is aborted, only those tracks that were 

scanned will be represented in the upcoming 
display. In about 70 seconds (more, if a lot of 
errors are encountered) the scan will finish and 
you will be presented with a map representing one 
fourth of the total disk. 
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The map will be displayed in four quadrants 
numbered 1 through 4. Quad 1 will be displayed 
automatically. Pressing the number keys 1,2, 3 or 
4 will display their respective quadrants. We have 
scanned Commodore's 1581 Demo/Utilities Disk 
(included with your 1581 Disk Drive) and printed 
the results as a sample. (See Below) 
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Quad 

1 

= Tracks 

01 - 40, 

Sectors 

00 - 20 

Quad 

2 

= Tracks 

41 - 80, 

Sectors 

00 - 20 

Quad 

3 

= Tracks 

01 - 40, 

Sectors 

21 - 39 

Quad 

4 

= Tracks 

41 - 80, 

Sectors 

21 - 39 


In any screen display, the following symbols 
apply: 

+ : This represents data present in the sector. 

- : This represents a sector that has never had 
data written to it. 


Numbers : A number in a sector means a DOS error 
is present on that sector. A number from 0 
through 9 will be displayed. Add 20 to the 
number shown to get the true error number. 
Example: a 3 is displayed, add 20 plus 3 to 
get 23, a checksum error. If you look in Your 
1581 Owner's Manual included with your 1581 
disk drive, you will find a listing of all 
possible DOS Errors. 

/? /r 
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While in the Quad mode, the following keys are 
active. 


n\ 

1, 2, 3, 4 t : See above. 

^ /) Ja ( - 

: Begin printout on any printer capable of 
emulating the Commodore 801/1525 printers. See 
n example printout included. 


n 


Back Arrow : Escape to Error Scanner Main Menu. 


RESTORE : Abort to main Error Scan menu. 
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The other Main Menu options are: 

NEW DRIVE: 

With this option, you can select one drive 
out of a possible of four 1581 disk drives. Device 
numbers available are 8, 9, 10 and 11. 

REBOOT MAIN MENU: 


n When you select this command, the 1581 

Toolkit will ask you to place the Toolkit disk in 
the drive bearing the device number from which you 

ns fiESfc_ loaded the program . After you press the 

Space Bar, the program will reboot. 


n DISK COMMAND: 
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This option gives you direct access to the 
1581 drive without the headache of using the OPEN 
statement. All standard disk commands are 
available including the ability to change 
partitions. This option acts as any other standard 
DOS wedge. There is no need to type the 
< OPEN 15.8.15. 11 > portion of the command. Simply 
type in the command desired at the flashing 
cursor. For example, to initialize any diskette in 
the current drive, just type in < 10 > . To 

initialize a partition or sub-partition, use the 
/ command. As an example, let's say you have a 
partition on the disk called ' PART 1 '. First, 
select the DISK COMMAND option from the menu. 
You'll then prompted with •'Command?". At this 
point type in < /PART l > and press RETURN. You 
have now initialized the partition called ' PART 1 
'• Any disk access now concerns itself solely with 
that partition. To return to the root directory, 
simply type in < / > at the "Command?" prompt and 
press RETURN. To list the directory, use the F1/F3 
keys which are active in this mode. 


n 


1581 Toolkit v2 


-39- 


< c > 1989 H.O.S. INC. 



F1/F3: 


Pressing F1/F3 will display a listing of the 
directory or partition of the diskette in the 
current drive. Pressing the Space Bar while the 
directory is scrolling will stop the scroll. 
Pressing the Space Bar again will continue the 
listing. Use the RUN/STOP key to abort the 
listing. 


RE-LOCATABLE FAST LOADER 

Although the 1581 disk drive's loading speed is 
a vast improvement over the 1541, there is still room 
for improvement. Those of you with a hardware fast 
load enhancement will appreciate the true 
capabilities of the 1581. For those of you without 
the hardware, or those who want more flexibility, our 
Fast Loader has capabilities that even the hardware 
products can't deliver. 

Our Fast Loader has several advantages in its 
favor. For instance, 900% faster loading of your 
program files. It's re-locatable in memory, and has 
the ability to save a Fast Loader to disk. Although 
the Fast Loader may be saved to a 5.25” as well as a 
3.5” diskette, it is only compatible with the 1581. 

From the Toolkit Main Menu select and load the 
Fast Loader option. When the Fast Loader menu 
appears, you will be presented with the following 
options: 

EXECUTE FASTLOADER: 

Use this option to install the Fast Loader 
into computer memory. The Fast Loader code will 
automatically send the proper information to the 
disk drive as needed. Follow the on screen 
information for valid placement of the Fast Loader 
code into computer memory. Just type the desired 
location in HEX at the flashing Cursor and press 
RETURN. You'll be returned to the standard BASIC 
screen with the Fast Loader installed message 
along with it's residing address. From here on, 
load any files you wish as usual. The only 
exception is that you can't successfully load 
files that override the location of the Fast 
Loader code in the computer's memory. 

SAVE FASTLOADER: 
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Use this option to install the Fast Loader 
onto any work disk. Follow the on screen 
information for valid placement of the Fast Loader 
code into computer memory. Just type the desired 
location in HEX at the flashing cursor and press 
RETURN. You'll be prompted to "insert work disk" 
and press the Space Bar. Upon doing so, the drive 
will become active and a "Saving Files" message 
will appear. After the save is complete, the Fast 
Loader Main Menu will re-appear. Read the 
directory of the work disk with the F1/F3 keys. 
You'll see that two files were saved. The 
"FastxxOO" (xx is the high byte you specified) is 
the autoboot for the "FxxOO" file which is the 
actual Fast Loader code. To install this Fast 
Loader, simply type < LOAD "FASTxxOO".8.1 > and 
press RETURN. Please note that the Fast Loader may 
be loaded from device numbers 8,9,10,or 11. 

NEW DRIVE: 

With this option, you can select one drive 
out of a possible of four disk drives. Device 
numbers available are 8, 9, 10 and 11. 

REBOOT MAIN MENU: 

When you select this command, the 1581 
Toolkit will ask you to place the Toolkit disk in 
the drive bearing the device number from which you 
first l oad ed th e...pmg ra m- After you press the 
Space Bar, the program will reboot. 

DISK COMMAND: 

This option gives you direct access to the 
1581 drive without the headache of using the OPEN 
statement. All standard disk commands are 
available, including the ability to change 
partitions. This option acts as any other standard 
DOS wedge. There is no need to type the 
< QP . EN - IS j fi j JlS J! > portion of the command. Simply 
type in the command desired at the flashing 
cursor. For example, to initialize any diskette in 
the current drive, just type in < 10 > . To 
initialize a partition or sub-partition, use the / 
command. As an example, let's say you have a 
partition on the disk called ' PART 1 '. First, 
select the DISK COMMAND option from the menu. 
You'll then prompted with "Command?". At this 
point type in < /PART 1 > and press RETURN. You 
have now initialized the partition called ' PART 1 
'. Any disk access now concerns itself solely with 
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that partition. To return to the root directory, 
simply type in < / > at the "Command?” prompt and 
press RETURN. To list the directory, use the F1/F3 
keys which are active in this mode. 

F1/F3: 


Pressing F1/F3 will display a listing of the 
directory or partition of the diskette in the 
current drive. Pressing the Space Bar while the 
directory is scrolling will stop the scroll. 
Pressing the Space Bar again will continue the 
listing. Use the RUN/STOP key to abort the 
listing. 
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If at any time within 90 days of purchase, the 
1581 Toolkit diskette becomes defective, you may call 
1-800-356-1179 ( 206-695-1393 outside of the 48 

states ) for a ReoLacemei^ Number . This 

RA# must appear on the outside of the package 
containing the diskette being returned. We will 
replace your defective original diskette as soon as 
possible. We will expect YQIUFO _BE A REGISTERED OWNER 
• NO EXCEPTIONS. Replacements will be given at no 
charge, upon receipt of your defective diskette, 
postage paid. 


THE 1581 TOOLKIT V2 
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This book is copyrighted. No part of this book 
may be reproduced, stored in a retrieval system, or 
transmitted in any form or by any means, electronic, 
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Every effort has been made to insure complete 
and accurate information concerning the material 
presented in this book. However, David W. Martin can 
neither guarantee nor be held legally responsible for 
any mistakes in printing or faulty instructions 
contained in this book. The author will always 
appreciate receiving notice of any mistakes. 

1541, 1571, 1581, Commodore 64, Commodore 128, BASIC 
7.0 , BASIC 2.0 and Amiga are trademarks or 
registered trademarks of Commodore Int., Ltd. 

CP/M is a.registered trademark of Digital Research, 
Inc. 



This book is dedicated to 
my family 

on both sides of the Atlantic. 

* * * 

Dieses Buch ist gewidnet zu 
meine Familie 

an beiden seiten von den Atlantik. 
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First, I'd like to point out that this book is not a 
substitute for the 1581 manual provided by Commodore. 
So don't throw that book away yet. My book is 
designed to compliment the Commodore book that in 
many ways is a step ahead of previous Commodore disk 
drive manuals. They actually provided information on 
the DOS in the 1581 book. I was really impressed by 
it, but the need to learn and know more gave me the 
desire to write the book you are reading: The 1581 
DOS Reference Guide . 

I'm sure that many of you share the same 
feelings as I do. It is always best to know as much 
about the equipment you use that's possible. That way 
you can get that extra ounce of performance out of 
it, etc. Well this books goal is to give you that 
information the rest is up to you. So get cracking! 
Let's see some really hot 1581 disk utilities. 

Speaking of hot utilities, the folks at Software 
Support International have done their part in 
creating the best 1581 utility package around. In 
fact, you'll find the hottest 1581 utility around 
included on a disk with this book. It's one software 
package that no 1581 owner should be without. It will 
catch your 1581's real spirit and let it fly high! 

The second thing I'd like to mention is about 
the memory maps in Chapters 6 through 8. The maps 
provided do not contain any of the original program 
code contained within the 1581's DOS ROMs. The 
reasons behind this are many, but basically the main 
reason is the fact that Commodore now includes a 
copyright message within the DOS ROMs that would 
hamper publication of an extensive memory map. 
Therefore, I am only providing routine addresses, 
labels and descriptions in the DOS ROM memory map. 

The third thing I'd like to mention is that this 
book is not going to teach beginners to program the 
1581 DOS. It's contents are provided as a reference 
to experienced computer programmers, DOS programmers 
and beginners interested in what makes the 1581 tick. 
If you are new to DOS programming I suggest that you 
pick up any of the books mentioned in the recommended 
reading section in chapter 9. The books listed there 
will help those of you who are interested in 
programming other Commodore or compatible drives 
(i.e. 1541, 1571, and MSD drives). 

In closing I'd like to say thanks for buying 
this book. The book has been a product of many man 
hours plus the usual blood sweat and tears. Please 
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encourage your friends to buy this book and it's 
companion disk. Do not pirate these products. It only 
hurts me and you in the end. Remember! Just say NO to 
piracy! 

David W. Martin 
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Chapter 1 ~ New Disk Drive Commands 
1581 Extended Block Read and Write 

The 1581's extended BLOCK-READ and BLOCK-WRITE 
commands allow you to read tracks and sectors that 
are beyond the normal range used by the DOS. They 
function in a manner that is similar to the U1 and U2 
commands, except the ILLEGAL TRACK AND SECTOR message 
is bypassed. As in the U1 and U2 commands the buffer 
pointer is initialized to point at the first byte in 
the sector read. 

I have not found a use for this feature yet, but 
it may possibly be useful in disk protection. For 
instance, the Amiga's disk drives can read out past 
track 80 and data can be stored on these extended 
tracks. It maybe possible in the near future to 
format 1581 disks out past track 80 and then use the 
extended B-R and B-W commands to retrieve and store 
data there. These commands take the following format: 

EXTENDED BLOCK-READ 

PRINT#15,"B-x"?channel#;track#•?sector# 

(x = shifted R) 

or 

PRINT#15,"B-";CHR$(210);channel# ?track#;sector# 

* * * 

EXTENDED BLOCK-WRITE 

PRINT#15,"B-x";channel#?track#;sector# 

(x = shifted W) 

or 

PRINT# 15, 11 B-" ? CHR$ (215); channe 1 #; track# ? sector# 

* * * 

1581 UTILITY LOADER - 

The 1581's Utility Loader (UL) command is a 
handy feature that can be used to load and execute 
machine language DOS programs inside the 1581. It's 
command structure is as follows: 

PRINT#15,"&0:filename" 
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The file loaded by this command must be in the 
following format: 

Byte 0 - Low byte of start address 

Byte 1 - High byte of start address 

Byte 2 - Number of program bytes 

Byte 3 - Data bytes containing program code 

Byte x - 

Byte x+1 - Checksum 
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The file type must be of type USR so the UL will O 

function properly and you are limited to a program . 

size of 251 bytes. Program data bytes MUST start at w 

byte three. O 


The start address also doubles as the load 
address of the program in the disk drive's RAM and 
execution will begin at that point. Upon execution of 
an RTS instruction control will return to the user. 

The checksum is always the byte following the 
last data byte. It is calculated by adding the 
starting address, the number of data bytes and the 
data bytes themselves together. If this calculation 
results in a carry it is counted along with the 
checksum. 
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Appendix A contains some demo programs that 
demonstrate the usage of the UL command. The PRG-2- 
USR program will take your machine language program 
file on disk and convert it to a USR file that is 
compatible with the UL command. The DEMO & CMD 
program loads a USR file on disk that demonstrates 
the command by flashing the disk drive error 

light before returning control of the disk drive to 
the user. 


* * * 

1581 AUTO LOADER 
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The 1581's auto loader is a handy feature for w 

executing a DOS program automatically when the drive vJ 

performs any of the following functions: power-up, 
reset, burst inquire, burst query, or the initialize ^ 

command. During these operations the 1581 looks for a 

_ U 
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file called "COPYRIGHT CBM 86" that is a USR type 
file. This file must follow the same format used in 
the utility loader mentioned previously. The file 
will be loaded and executed if it is present on the 
disk in the drive. 

The automatic loading feature can be disabled in 
the following ways: 

(1) Renaming the file (easiest) 

(2) Setting a flag in the BAM 

(3) Setting a flag in DOS RAM 

After executing the program must call the 
JCBMBOOTRTN ($FFBA) to return control to the 1581. 

Appendix A contains a file that will demonstrate 
the 1581's auto loading file capability. The AUTOBOOT 
DEMO program will cause the 1581's error LED to flash 
as in previous examples. 

Notes: 

1) See location $01FB in the RAM memory map. Bits 7 
and 6 control the autoboot sequence. 

2) See byte number 7 in the BAM (track 4 0 sectors 1 
and 2) it controls the autoboot sequence also. 

* * * 

1581 DISK PARTITIONING 

The 1581 supports disk partitioning via the "/" 
command. Disk partitioning provides a means of 
protecting portions of the diskette. This was 
provided so that users could permanently reserve 
space on a diskette for BOOT sectors, CP/M data, or 
random access files. 

Reserving disk space has always been easy via 
the BLOCK-ALLOCATE command (B-A). The B-A command 
would set a bit in the BAM that would protect the 
sector from being over written by normal DOS 
commands. The BLOCK-FREE (B-F) command could then be 
used to deallocate a selected disk sector. 

Although easy to use the B-A command is not 
without problems. It's main problem has always been 
the fact that sectors that are allocated by it can be 
de-allocated by the DOS VALIDATE command. 

This is where the disk partition command steps 
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in. It prevents the deallocation of special blocks by 
the VALIDATE command. This is because the VALIDATE 
command skips partition files that are designated as 
file type CBM. 

CBM files are created when you set up a 
partition and they insure the protection of the 
selected area on the diskette. As long as the CBM 
file exists the data will be protected from the 
VALIDATE command. 

Partitions are named the same way as other disk 
files on the 1581. Like them you are limited to 
sixteen characters, etc. When listing a directory 
they appear as file type CBM. 

The create a partition command is as follows: 

PRINT#15, H /0:partition name,"+CHR$(starting 
track)+CHR$(starting sector)+CHR$(low byte 
of sectors )+CHR$( high byte of sectors )+*' ,C M 

Larger partitions can be used as sub¬ 
directories. There are, however, some limitations if 
you plan on using parts of a partition as a 
sub-directory. They are: 

(1) The partition area must be at least 120 sectors 
in size 

(2) The starting sector must always be 0 

(3) The ending sector must always be a multiple of 
40 

(4) The area allocated cannot contain track 40 
(which is the original system track for the root 
directory) 

Many levels of sub-directories can be created. 
The figure below shows a graphical representation of 
multiple level disk partitions. 

ROOT DIRECTORY "/" 

i 


/0:PARTITION1 /0:PARTITION2 

i 

/0:PARTITI0N2A 

i 

/0:PARTITION2B 

Once disk partitions are created they can be 
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selected via the command: 

PRINTS15, M /o:partition name" 

The first time you open a disk partition you 
must format it via the DOS NEW command. Care should 
be taken that the selected partition is available or 
you may end up formatting the entire diskette. You 
can check to see that you have selected the right 
partition via the error channel. If everything is ok 
then reading the error channel should produce: 

02, SELECTED PARTITION,first track#,last track# 

If the error channel produces: 

77, SELECTED PARTITION ILLEGAL,00,00 

then you must reattempt to select the partition 
again. It either does not exist or you misspelled the 
file name. 

Directories can only be accessed in a forward 
direction. If you need to go back to a directory a 
level above the current one, you must first select 
the root directory via: 

PRINT#15,"/" 

Then you will need to work your way down through 
the other directories until you reach the level you 
need. The example below shows you how to switch 
between multiple level directories. 

Example: Multiple Directory Switching 

PRINT#15,"/":PRINT#15,"/0:PARTITION2": 

PRINT#15,"/0:PARTITION2A" 

(Places the current directory at PARTITION2A) 
PARTITION NOTES 

The selected partition becomes the default 
working area. All accesses to the disk drive will 
only be done in this area. Files outside this area 
are invisible to you as if they do not exist. 

The first track of a disk partition acts like 
track 40 in the root directory. It is your 
responsibility to see that no information over writes 
this track or corrupts the data on it. The DOS only 
protects track 40 of the root directory. 
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Removal of partitioned areas is easy. Simply (^j 

SCRATCHING the partition file entry in the 
appropriate area will free up the allocated disk ^ 

space. Files in the partition will be lost, so be ^ 

sure to copy the files that you might need later. 


-V IE WJL 581 U 

The 1581 disk drive supports two commands not ^ 

listed in the manual supplied with the 1581 they are O 

the "B-*" command and the "B-?" command. 

The "B-*" command is the dedication message 
placed in the DOS by one of it's designers. Sending 
this command via the command channel and then reading ^ 
that channel generates the message: 


"7: , DEDICATED TO MY WIFE LISA, 00,00" 

Notice the odd error message number. It 
represents error number $7A in the DOS. 

The "B-?" command is the author message. It 
tells you who designed the 1581 hardware and 
software. If you want to see this message send it via 
the command channel and then read that channel it 
will generate the following message: 

"79,SOFTWARE DAVID SIRACUSA. HARDWARE GREG BERLIN" 

Hidden messages seem to be a recurring item in 
most new Commodore products. The C128D is the first 
piece of equipment where I encountered this novelty. 
If you want to see the C128's hidden message simply 
type the following in C128 mode: 

SYS32800,123,45,6 (Hit RETURN) 

The 1571 disk drive also contains a message near 
the beginning of it's operating system ROM ($8000). 
Currently, I am not aware of a DOS command that will 
cause it to be printed via the command/error channel. 
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Chapter 2 - Disk Format Structure 
1581 FORMAT ORGANIZATION 


O 

n 
r\ 
r ^ 
n 

rN 

o 

O 

rs 

r^s 

r\ 

r\ 

rs 

r> 

n 

r> 

r\ 

n 

/~s 

n 

n 

o 

o 

Oi 

rs 

r\ 

n 

n 

r\ 

o 

O 

o 

o 

O 

n\ 


Gross Data Organization: 

3.5 inch disk 

Double-sided 

80 cylinders/160 tracks 

Physical Format Organization: 


Cylinders 0 thru 79 
Sectors 1 thru 10 on side 0 
Sectors 1 thru 10 on side 1 
Sector size 512 bytes 

Logical Format Organization: 

Tracks 1 thru 80 

Sectors 0 thru 39 (using physical sectors 1 
to 10 sides 0 and 1) 

Sector size 256 bytes 


Storage: 


Total unformatted capacity 
Total formatted capacity 
Maximum sequential file size 
Maximum relative file size 
Records per file 
Files per diskette 
Cylinders per diskette 
Logical sectors per cylinder 
Physical sectors per cylinder 
Free blocks per disk 
Logical bytes per sector 
Physical bytes per sector 


1 Megabyte 
808,960 bytes 
802,640 bytes 
approx. 800K 
65535 
296* 

80 

40 (0 to 39) 

20 (1 to 20) 

3160 

256 

512 


* More with disk partitioning 
partition can hold another 


(each 

296 files) 


* * * 
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1581 TRACK AND SECTOR LAYOUT 


1581 per track organization: 

Hex 4E written as a gap, with 10 sectors of 
data, with full gaps written for motor speed 
variation. 

1581 per sector organization: 

MFM encoded contents of each sector: 

12 bytes of $00 

3 bytes of hex $A1 (data hex $A1, clock 
hex $0A) 

1 byte of $FE (ID address mark) 

1 byte (track number) 

1 byte (side number) 

1 byte (sector number) 

1 byte (sector length, $02 for 512 byte 

sectors) 

2 bytes CRC (cyclic redundancy check) 

22 bytes of hex $4E 

12 bytes of $00 

3 bytes of hex $A1 (data hex $A1, clock 

hex $0A) 

1 byte of hex $FB (data address mark) 

512 bytes of data 

2 bytes CRC 

38 bytes of hex $4E 

* * * 
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1581 PHYSICAL TO LOGICAL FORMAT CONVERSION 
CYLINDERS VS. TRACKS 

The 1581's physical cylinders range from 0 to 79 
on the disk surface, whereas logical tracks range 
from 1 to 80. 


O 

o 


To convert from cylinders to tracks use the 
following formula: 


n 
n 
n 
n 
r ^ 


CYLINDER # + 1 = TRACK # 

To convert from tracks to cylinders use the 
following formula: 

TRACK # - 1 = CYLINDER # 




* * * 


n 

n 


Sector Conversion 

Physical to logical sector conversions are where 
we approach the hard part of the conversion process. 
We actually have to do a little bit of math. 


^ The 1581 9 s physical sectors occupy sectors 1 

^ thru 10 on sides 0 and 1 of the diskette and contain 

512 bytes of information per sector. The eguivalent 
n logical sectors can be computed using the following 

formulas: 



LOGICAL 

n 

(20 * 

n 

LOGICAL 

n 

(20 * 


SECTOR A = (PHYSICAL 
SIDE#) 

SECTOR B = (PHYSICAL 
SIDE#) 


SECTOR# * 2) - 2 + 
SECTOR# * 2) - 1 + 


n 

r\ 

r\ 

ns 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 


NOTE: Since a physical sector contains two 
logical sectors you must remember to work on each 
part of the 512 byte block as two 256 byte blocks. 
Logical sector A is equivalent to: START OF 512 BYTE 
DATA BLOCK + 0 and logical sector B is equivalent to: 
START OF 512 BYTE DATA BLOCK + 256. 

The 1581's logical sectors occupy sectors 0 thru 
39 on sides 0 and 1 of the diskette and contain 256 
bytes of information per sector. The equivalent 
physical sectors can be computed using the following 
formulas: 
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SIDE 0 - LOGICAL SECTORS 0 TO 19 


PHYSICAL SECTOR = (LOGICAL SECTOR EVEN# + 1) / 2 
+ .5 + (20 * SIDE#) 

PHYSICAL SECTOR = (LOGICAL SECTOR ODD# + 2) / 2 

- .5 + (20 * SIDE#) 

NOTE: SIDE# = 0 in the two formulas above. 

SIDE 1 - LOGICAL SECTORS 20 TO 39 

PHYSICAL SECTOR = (LOGICAL SECTOR EVEN# + 2) / 2 

- .5 - (10 * SIDE#) 

PHYSICAL SECTOR = (LOGICAL SECTOR ODD# + 1) / 2 

- (10 * SIDE#) 

NOTE: SIDE# = 1 in the two formulas above. 


The following chart may also be useful as a 
quick reference for physical to logical sector 
conversions. 

SIDE 0 SIDE X 

PHYSICAL LOGICAL PHYSICAL LOGICAL 


1 

o, 

1 

1 

20, 

21 

2 

2, 

3 

2 

22, 

23 

3 

4, 

5 

3 

24, 

25 

4 

6, 

7 

4 

26, 

27 

5 

8, 

9 

5 

28, 

29 

6 

10, 

11 

6 

30, 

31 

7 

12, 

13 

7 

32, 

33 

8 

14, 

15 

8 

34 , 

35 

9 

16, 

17 

9 

36, 

37 

10 

18, 

19 

10 

38, 

39 


* * * 
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o 

Directorv Track 

r\ 




r \ 

The 1581's directory track is located on logical 

track 40 and is 40 

disk sectors in length. The DOS 

n 

uses the directory 

to 

manage up to 296 files per 

r\ 

diskette. 



n\ 

The directory is composed of 40 disk blocks the 


first three have special 

functions (sectors 0, 1, and 

.2) the last 37 are used 

for file storage information 

n 

(8 files per sector. 

8 * 

37 = 296). 


Below are charts showing you the contents of 

r\ 

sectors 0, 1, and 2 

which are the directory header, 

r\ 

BAM one, and BAM two 

respectively. 

r ^ 

Directory Header 

(Track 40. Sector 01 

r\ 

Byte # 


Description 

r\ 

0 


Track containing next 

r*\ 



directory block (normally 




40/$28) 


1. 


Sector containing next 

r> 



directory block 




(normally 3/$03) 


2 


Disk version number 
(normally 68/$44 ASCII "D") 

r\ 



r\ 

3 


Null byte (0/$00) 

r\ 

4-19 


Disk Name (16 characters) 


20-21 


Shifted spaces (160/$A0) 

■'r*\ 




n 

22-23 


Disk ID (2 characters) 


24 


Shifted space (160/$A0) 


25 


DOS version number (normally 




51/$33 ASCII "3") 


26 


Disk version number 

o 



(normally 68/$44 ASCII "D") 


27-28 


Shifted spaces (160/$A0) 

n 





29-255 


Null bytes (0/$00) 


NOTE: Locations 

29 

to 255 are not used by the 


DOS a variety of things 

can be stored here. Examples 
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are: text data, DOS programs, messages, etc. Use your 
imagination. Also, changing byte 3 to anything other 
than 68/S44 will "soft-write-protect" a diskette. 


-BAM - Block Availability Ma 


The BAM is located on sectors 1 and 2 on logical 
track 40 of a 1581 diskette. The BAM is used to keep 
track of blocks on the disk that are either reserved 
or available. 


0 Track containing next BAM 

block (normally 40/$28) 

1 Sector containing next BAM 

block (normally 2/$02) 

2 Disk version number (normally 

68/$44 ASCII "D") 

3 Compliment version number 

(normally 187/$BB) 

4-5 Disk ID (2 characters) 

6 Input/Output byte 

Bit 7 Verify on/off 

Bit 6 Check header CRC 
on/off (normally 192/$C0) 

7 Auto loader flag (normally 

0 /$ 00 ) 

8-15 Null Bytes (normally 00/$00) 

16-255 BAM image (logical tracks 1 

to 40 using 6 bytes per 
track) 
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BAM 2 - Logical Tracks 41-80 (Track 40. Sector 2\ 


r\ 
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n 
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p 
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p 

p 

P 
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p 
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r*\ 

P 
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P 

p 

p 

p 

p 

p 

p 

p 

p 

p 

P 

p 

p 

p 

P 

p 

p 

P 

P 
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Byte # 

0 

1 

2 

3 


4-5 

6 


Description 

Track containing next 
BAM block (normally 0/$00) 

Sector containing next BAM block 
(normally 255/$FF) 

Disk version number (normally 
68/$44 ASCII "D") 

Compliment version number 
(normally 187/$BB) 

Disk ID (2 characters) 

Input/Output byte 

Bit 7 Verify on/off 

Bit 6 Check header CRC on/off 
(normally 192/$C0) 


7 Auto loader flag (normally 0/$00) 

8-15 Null Bytes (normally 00/$00) 

16-255 BAM image (logical tracks 41 to 

80 using 6 bytes per track) 

NOTE: Bytes 2 thru 7 are copies of the bytes 
appearing in BAM 1 (Track 40, Sector 1). 


* * * 


BAM Image Interpretation 

The bytes containing the BAM image are used as 
follows: 


Byt e JL 

0 

1 

2 


Description 

Number of free sectors on the 
track 

Each bit marks a sector 
(sectors 0 to 7) 

Each bit marks a sector 
(sectors 8 to 15) 
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Bvte # 


Description 


3 

Each bit marks a sector 
(sectors 16 to 23) 

4 

Each bit marks a sector 
(sectors 24 to 31) 

5 

Each bit marks a sector 
(sectors 32 to 39) 

A sector is free if it's representative bit 
equals one. If the bit value is zero then the sector 
is reserved. 


* * * 

File Information 

Sectors (Track 40. Sectors 3-39) 

Bvte t 

Description 

0 

Track of next directory block 
(normally 40/$28) 

1 

Sector of next directory block 
(normally 4/$04 and incrementing 
by one on each of the following 
directory sectors) 

2-31 

File entry number 1 

34-63 

File entry number 2 

66-95 

File entry number 3 

98-127 

File entry number 4 

130-159 

File entry number 5 

162-191 

File entry number 6 

194-223 

File entry number 7 

226-255 

File entry number 8 

NOTE: There 
entry they contain 
are reserved for 
next page). 

are two bytes between each file 
a null value (0/$00). Thirty bytes 
each file or directory entry (see 


* * * 
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r\ 



r^s 



n 

Directorv/File Entrv Structure 

r ^ 



n 

n 

Byte # 

Description 

0 

File types: 



0 = Deleted file (DEL) 

n 





1 = Sequential file (SEQ) 

r\ 


2 = Program file (PRG) 



3 = User file (USR) 

n 


4 = Relative file (REL) 



n 


n 


5 = CBM file (CBM) 

o 


If the file type is OR'ed 

n 


with 128/$80 then it is a 
properly closed file. 

r*\ 




If the file type is OR'ed 



with 192/$C0 then it is a 



locked file and cannot be 



scratched. 


1 

Track of first data block 

/^S 

2 

Sector of first data block 


3-18 

File name padded with 



shifted spaces (160/$A0) 16 

n 


characters in length 

o 

19 

For relative (REL) files 

o 


only! Track of the super 
side sector block. 

o 



r\ 

20 

For relative (REL) files 

r*y 


only! Sector of the super 
side sector block. 

n 

21 

For relative (REL) files 



only! Record length. 

O 

22-25 

Null bytes (normally 0/$00) 

o 



n 

26 

Track number of replacement 


file during a SAVE or OPEN 

n 


with replace "G" 

n 
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Byt e # 

27 


28 

29 


Description 

Sector number of replacement 
file during a SAVE or OPEN 
with replace H @" 

Number of blocks in the file 
(low byte) 

Number of blocks in the file 
(high byte) 

* * * 


Ez o gE s m JE l lg- S to r ag e 
Sector 1 


- B yte-JF 

o 

1 

2 

3 

4-255 


-Rg.sp x i. pti o n_ 

Track of next block in the 
program 

Sector of next block in the 
program 

Program load address (low 
byte) 

Program load address (high 
byte) 

Pronram information stored 
on iisk 


Remaining FullProgram Sectors, 
Byte # Description 


0 Track of next block in the 

program 

1 Sector of next block in the 

program 

2-255 Program information stored 

on disk 
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Last Program Sector 


rs 

rs 

r ^ 

O 
rs 
r> 
n 
rs 
r ^ 
rs 
n 

n 

n 

rs 

O 

n 

r> 

r\ 

r> 

rs 

rs 

n 

n 

-o 

/r 

rs 

r> 

r\ 

n 

O 

/-S 

n 

rs 

rs 

rs 

rs 

rs 

rs 

rs 


Byte # 

0 

1 

2-xxx 


Description 

Null byte (normally 0/$00) 

Number of valid data bytes 
in this sector 

Last bytes of program 
information 

* * * 


Sequential/User File Storage 


Byte # 


Description 


0 


Track of the next sequential 
data block 


1 

2-255 


Sector of the next 
sequential data block 

Data bytes (254) 


NOTE: The last sector for the sequential/user 
files above is the same as the one for program files. 


* * * 
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Relative File Storage 

Relative File Data Blocks 

B yte I. DescriPtion 

0 Track of next data block 

1 Sector of next data block 

2-255 Data bytes. Normally 

relative files records are 
empty if the first record 
byte is 255/$FF. The 
remaining bytes are filled 
with nulls (0/$00). Records 
that are partially filled 
are padded with nulls. 

Relative File Side Sectors 


Bvte # 

Description 



0 

Track of next side 
block in the current 

sector 

group 

1 

Sector of next side 
block in the current 

sector 

group 

2 

3 

Side sector number 

Record length 

(0 

to 5) 

4-5 

Track and sector 
sector 0 

Of 

side 

6-7 

Track and sector 
sector 1 

Of 

side 

8-9 

Track and sector 
sector 2 

of 

side 

10-11 

Track and sector 
sector 3 

of 

side 

12-13 

Track and sector 
sector 4 

of 

side 

14-15 

Track and sector 

of 

side 


sector 5 

16-255 Track and sector pointers to 

120 data blocks 
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Relative File Super Side Sectors 

Byte # Description 

0 Track of first side sector 

group 0 


1 Sector of first side sector 

group 0 


o 

2 

Value 

254/$FE 



3-4 

Track 

and sector of 

first 

n 


side 

sector in group 

0 

n 

5-6 

Track 

and sector of 

first 



side 

sector in group 

1 

n 

. 




n 

253-254 

Track 

and sector of 

first 



side 

sector in group 

125 


NOTE: Each super side sector has pointers to 
O groups of 126 side sectors. Each side sector group 

^ contains 6 side sectors. Now, each side sector block 

points to 120 data blocks, each of which contain 254 
data bytes. Thus, the maximum relative file size is 
_ 23,042,880 bytes (126 * 6 * 120 * 254 = 23,042,880). 


n 


* * * 


n 

n 

r*\ 


_Delgtg d_Eilg Storag e 

Deleted files on a diskette are represented by 
DEL when you list a disk directory. They can be 
manipulated like over files via LOAD and OPEN 
commands. However, when loading a DEL file type you 
must use the following LOAD command: 

LOAD "PRGNAME,DEL,R",8 




or 




OPEN 8,8,8,"PRGNAME,DEL,R” 


n 

o 


NOTE: DEL maybe abbreviated to just "D. " 

Experiment with the various commands for loading 
and saving data and see what results you get. The 
commands above are also useful on program, 
sequential, and user files. 


O 

^ • Copyright 1988 D. W. Martin All Rights Reserved. 

r*\ The 1581 DOS Reference Guide -19- Chapter 2 



Locked File Storage 


Locked files are files that cannot be scratched 
from the diskette. In order to scratch a locked file 
you must first unlock it. When listing a directory, a 
locked file will have a less than ("<") symbol 
appended after the file type. 

The DOS does not currently have a command that 
will set the lock bits on the file type. You must 
either set the bit by hand using a sector editor or 
you can use a variety of public domain programs that 
will let you choose a file name to lock. 

A program that will lock and unlock files on the 
1581 is provided on the companion disk. See Appendix 
A for more information on 81FILELOCKON.OFF program. 
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Chapter 3 - Using Burst C ommands 

Commodore 128 owners will be happy to discover 
that the 1581 supports the burst protocol that was 
first introduced in the 1571. The protocol provides 
fast serial transfers of data and programs between 
the disk drive and computer. 

The Commodore 128 computer is currently the only 
computer that supports the burst protocol. The C128's 
enhanced serial communication hardware and 2 Mhz 
clock speed make this possible. The C64's hardware 
cannot support the burst protocol since it lacks the 
Cl28' s enhancements. 

Unfortunately, the hardware is not the only 
limitation involving the burst protocol. Another is 
software support. BASIC cannot properly handle burst 
transfers since it is to slow. So in order to 
properly access burst transfers a programmer must 
turn to machine language. 

Fortunately, Commodore has provided machine 
language burst routines on the 1581 demo disk that 
run on the C128. They provide the ML routines, their 
source code and some sample programs. The sample 
programs show you how to use their ML burst routines 
with BASIC. 

The source code files are provided in the CBM 
Macro Assembler format. You can use these files in 
other assemblers with some changes. However, one 
problem you may encounter is that some or all of the 
demo disks contain a defective source code file (if 
you find a good one let me know). You may need to 
make a new source file (using the supplied object 
file) with a disassembler. 

The list file is intact, but it is not useful as 
a file for an assembler. However, it's very useful as 
a burst routine reference and it contains the 
documentation for the burst routines. I recommend 
that you print out a listing of this file and that if 
you do you should print it out in 132 columns on your 
printer. Note, that if you do not set your printer to 
print in 132 column compressed print the listing will 
be hard to read. 

The following pages contain information on using 
the burst routines on the 1581. The burst command 
syntax is provided as a reference in a form that I 
hope is more understandable then the 1581 manual. No 
examples are provided as a tutorial. Instead I 
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suggest that you study the demo programs and source 
code for the burst routines that are provided on the 
1581 Demo/Utilities disk. 

_BURST_JREAD 

Command format: 


PRINT#1 5 ,"UO"+CHR$(A)+CHR$(B)+CHR$(C)+CHR$(D) 
+CHR$(E)? 


JBXTJL. -AIT. -DESCRIPTION 


A 7 

6 

5 

4 

3-1 

0 

B 0-7 

C 0-7 

D 0-7 

E 0-7 

PROTOCOL USED: 


LOGICAL FLAG (1 = DO LOGICAL TO 
PHYSICAL TRANSLATION) 

IGNORE ERRORS (1 = IGNORE) 

NOT USED 

SIDE SELECT (SIDE 0 OR 1) 

SET TO ZERO 

DRIVE NUMBER (ALWAYS 0 ON 1581) 
DESTINATION TRACK 
DESTINATION SECTOR 
NUMBER OF SECTORS 
NEXT TRACK (OPTIONAL) 

Burst mode handshake. 


OUTPUT RESULT: One burst status byte is sent, 
followed by the burst data. This occurs for each 
sector transferred. Errors prevent data from being 
sent unless bit 6 is set to one in byte A. 

* * * 
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BURST WRITE 
Command format: 


PRINT# 15 , "UO**+CHR$ (A) +CHR$ ( B) +CHR$ (C) +CHR$ (D) 
+CHR$(E)? 


BYTE 


B 

C 

D 

E 


BIT DESCRIPTION 

7 LOGICAL FLAG (1 = DO LOGICAL TO 

PHYSICAL TRANSLATION) 

6 IGNORE ERRORS (1 = IGNORE) 

5 NOT USED 

4 SIDE SELECT (SIDE 0 OR 1) 

3-2 SET TO ZERO 

1 SET TO ONE 

0 DRIVE NUMBER (ALWAYS 0 ON 1581) 

0-7 DESTINATION TRACK 

0-7 DESTINATION SECTOR 

0-7 NUMBER OF SECTORS 

0-7 NEXT TRACK (OPTIONAL) 


PROTOCOL USED: Burst data is sent to the drive. The 
host must then do the following for fast serial 
input. First, pull the clock low and wait for the 
burst status byte. Then pull the clock high and 
continue output for multiple sector transfers. 


r*) 

n 

n 

n 

o 

n 

o 

n 

o 


INPUT: The host must transfer burst data. 

OUTPUT RESULT: One burst status byte follows each 
write operation that is performed. 

The following hold true for both burst read and 
write: 

RANGE: All track and sector ranges are determined by 
the current disk format and format translation 
tables. 

CONVENTIONS: Before you can read or write to a 
diskette, you must first log the disk in using either 
the INQUIRE DISK or QUERY DISK FORMAT COMMANDS. You 
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must do this once every time you change a disk also. 

★ * ★ 

INQUIRE DISK 
Command format: 


PRINT#15,"UO"+CHR$(A)? 


BYTE 

BIT 

DESCRIPTION 

A 

7-5 

NOT USED 


4 

SIDE SELECT (SIDE 0 OR 

i) 

3 

SET TO ZERO 


2 

SET TO ONE 


1 

SET TO ZERO 


0 

DRIVE NUMBER (ALWAYS 0 

ON 1581) 

PROTOCOL USED: 

Burst mode handshake. 


OUTPUT RESULT: 

One burst status byte is 

sent aft 


each INQUIRE DISK operation is performed. 

* * * 


.J E PJ MM L. 

Command format: 

PRINT#15,"UO"+CHR$(A)+CHR$(B)+CHR$(C)+CHR$(D) 
+CHR$(E)+CHR$(F)+CHR$(G); 


B_YTE_ _ B ITj 


A 7 FORMAT MODE (1 = ACCEPT BYTES 

THREE TO EIGHT FOR CUSTOM 
FORMAT. 0 = DO STANDARD 1581 

FORMAT MAKE A BAM AND DISK 
DIRECTORY. DISK NAME = 

"COPYRIGHT CBM" DISK ID = "86") 


6-4 NOT USED 


3 SET TO ZERO 


2-1 SET TO ONE 
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<J 

u 
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v.J 
U 
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U 

U 
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u 
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<J 

u 

u 



n 

n 

n 

n 

n 
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n 

r^ 

n 

r^ 

O 

n 

r^ 

n 

r^ 

r^ 

r\ 
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r^ 

n 
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BYTE, _M£ 


DESCRIPTION 


0 DRIVE NUMBER (ALWAYS 0 ON 1581) 


B 


0-7 SECTOR SIZE. THE DEFAULT IS 2 FOR 

512 BYTE SECTORS. 


1 = 256 BYTE SECTORS 

2 = 512 BYTE SECTORS 

3 = 1024 BYTE SECTORS 


C 


0-7 LAST DISK TRACK NUMBER. THE 

DEFAULT IS 79. 


D 0-7 NUMBER OF SECTORS ON A TRACK. 

DEPENDS ON THE VALUE IN BYTE B. 
16 SECTORS PER TRACK FOR 256 
BYTE SECTORS. 10 SECTORS PER 
TRACK FOR 512 BYTE SECTORS. 5 
SECTORS PER TRACK FOR 1024 BYTE 
SECTORS 


0-7 

STARTING 
DEFAULT IS 

TRACK 

ZERO. 

NUMBER. 

THE 

0-7 

FILLER BYTE. THE 
$E5/229. 

DEFAULT 

IS 

i 

o 

STARTING 
DEFAULT IS 

SECTOR 

ONE. 

NUMBER. 

THE 


PROTOCOL USED: Uses conventional DOS protocol via the 
command channel (#15). 


OUTPUT RESULT: No output of status. The status is 
updated within the disk drive. 

CONVENTIONS: You must log the disk in using either 
the INQUIRE DISK or QUERY DISK FORMAT COMMANDS after 
using the FORMAT command. 


* * * 
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u 

u 

-QUER-Y_D I SK_ F . QRMAT O 

Command format: ^ 

O' 

PRINT#15,"UO M +CHR$(A)+CHR$(B)? 

-BYTE, -JLEE- _DE. gqRIPTIQN ^ 

A 7 FORCE FLAG (1 = STEPS THE HEAD ^ 

WITH THE OFFSET SPECIFIED IN m 

BYTE B. 

O 

6 NOT USED ^ 

5 SECTOR TABLE (1 = SEND SECTOR 

TABLE) 

4 SIDE SELECT (SIDE 0 OR 1) 

3 SET TO ONE ^ 

2 SET TO ZERO 

1 SET TO ONE ^ 

0 DRIVE NUMBER (ALWAYS 0 ON 1581) ^ 

B 0-7 OFFSET VALUE 

PROTOCOL USED: Burst mode handshake. 

OUTPUT RESULT: Depends on the following: ^ 

Status fron track offset of zero: only the burst w 

status byte is sent (no bytes will follow if an error ^ 

occurred). ^ 

Status from track offset set by user: ^ 

- burst status byte (no other bytes will ^ 

follow if an error occurred in compiling 
the MFM format information) 

- number of sectors on a particular track 

- logical track number found in the disk ^ 

header 

- the logical sector with the lowest value ^ 

- the logical sector with the highest value ^ 

- sector interleave (always returns a one) vj 

_ U 
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- sector table (sector table is sent when bit 
5 in byte A is set 

CONVENTIONS: This routine determines the diskette 
format on any particular track. It will also log in 
non-standard diskette formats. 

* * * 



IF BIT 7 = 0 AND BIT 6 = 1 THEN 
LOG IN DISK. 

IF BIT 7 = 1 AND BIT 6 = 1 THEN 
RETURN WHETHER OR NOT THE DISK 
WAS LOGGED IN (I.E., $0B ERROR 
OR PREVIOUS STATUS) 

5 CONTROLS THE SETTING OF THE WRITE 

AND/OR MASK. BYTE C CONTAINS THE 
NEW OR MASK, WHILE BYTE D 
CONTAINS THE AND MASK (WHEN BIT 
5 = 1) 

4 SET TO ZERO 

3-2 SET TO ONE 

1 SET TO ZERO 

0 DRIVE NUMBER (ALWAYS 0 ON 1581) 

B 0-7 NEW STATUS WHEN BIT 7 ON BYTE A 

IS ONE 

C 0-7 NEW ORA MASK WHEN BIT 5 ON BYTE A 

IS ONE 

D 0-7 NEW AND MASK WHEN BIT 5 ON BYTE A 

IS ONE 
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PROTOCOL USED: Uses conventional DOS protocol via the 
command channel (#15) when bit 7 on byte A is zero. 
If bit 7 on byte A is one then burst mode handshake 
is used. 

OUTPUT RESULT: No output of status when bit 7 on byte 
A is zero. The burst status byte is sent when bit 7 
on byte A is one. 

CONVENTIONS: This is the method used to read or write 
the current status. It may also be used to change the 
status mask value. 


* * * 


-DUMP TRACK CACHE BUFFER 
Command format: 


PRINT#15,"UO"+CHR$(A)+CHR$(B); 


.ML —BIX. 

A 7 

6 

5 

4-2 

1 

0 

B 0-7 


DESCRIPTION 

1 = WRITE TRACK CACHE BUFFER TO 
DISK EVEN IF IT'S NOT "DIRTY". 

SIDE SELECT (SIDE 0 OR 1) 

NOT USED 

SET TO ONE 

SET TO ZERO 

SET TO ONE 

PHYSICAL DISK TRACK NUMBER 

* * * 
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FASTLOAD UTILITY, 
Command format: 


PRINT# 15 , M UO**+CHR$ (A) +FILENAME$ 7 


BYTE. BIT_ DESCRIPTION . 

A 7 FILE CONTROL BIT. IF SET TO ONE 

FILE DOES NOT NEED TO BE A 
PROGRAM FILE. SETTING BIT 7 TO 
ONE CAN ALLOW YOU TO FASTLOAD 
PRG, SEQ, AND USR FILES. 


6-5 NOT USED 


4-0 SET TO ONE 

The character variable FILENAME$ above contains 
the name of the file you wish to fast load. It can be 
from one to 16 characters in length. 


PROTOCOL USED: Burst mode handshake. 


OUTPUT RESULT: The burst status byte is sent after 
each sector that is transferred. 


The status byte for the FASTLOAD UTILITY is 


decoded as follows: 

STATUS BYTE VA L UE. 
0 OR 1 
3 TO 15 
16 
31 


_MESSAGfi_ 

OK 

FILE READ ERROR 
FILE NOT FOUND ERROR 
EOI 


NOTE: A byte is sent following the EOI byte that 
represents the number of data bytes to follow. 


* * * 


BURST STATUS BYTE DECODED- 

The burst status byte contains a lot of 
information for such a small item. It contains 
information which includes the following: format 
mode, sector size and controller error messages. 

The status byte can be broken down as follows: 
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-BI-T_ DESCRIPTION 

7 DISK FORMAT MODE (1 = ALIEN DISK FORMAT 0 = 

RESIDENT/STANDARD DISK FORMAT) 

6 DRIVE NUMBER (ALWAYS 0 ON 1581) 

5-4 DISK SECTOR SIZE 

00 = 128 BYTE SECTORS (WHICH IS NOT 
SUPPORTED ON THE 1581) 

01 = 256 BYTE SECTORS 

10 = 512 BYTE SECTORS (WHICH IS THE 

DEFAULT VALUE ON THE 1581) 

11 = 1024 BYTE SECTORS 

3-0 DISK CONTROLLER STATUS 

Disk Control ler Status 

0000 = OK 
0001 = OK 

0010 = CANNOT FIND HEADER BLOCK 
0011 = NO ADDRESS MARK FOUND 
0100 = DATA BLOCK NOT PRESENT 
0101 = DATA CRC ERROR 
0110 = DISK FORMAT ERROR 
0111 = DISK VERIFY ERROR 

1000 = DISK WRITE PROTECT ERROR 

1001 = HEADER BLOCK CRC ERROR 

1010 = DISK IS WRITE PROTECTED 

1011 = DISK CHANGE OCCURRED 

1100 = DISK FORMAT IS ILLOGICAL 

1101 = RESERVED 

1110 = SYNTAX ERROR OCCURRED 

1111 = NO DISK DRIVE PRESENT 

* * * 


BUR SX.BQ U TIJ^HQTJg ^L . 

The most important thing to mention about the 
burst commands is that most of them must be executed 
by machine language programs since BASIC is not quite 
up to handling the burst protocols speed. 

The burst command must be executed by a machine 
language command whenever it specifies the use of the 
burst mode handshake. Other commands can be executed 
by BASIC programs (i.e. the burst format command). 
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Therefore, you must convert the BASIC command format 
in the text above to it's machine language 
equivalent. 

Using BASIC to show the command format was 
chosen because it is the language that most users are 
familiar with and the easiest to understand. 
Experienced programmers will find it easy to convert 
the BASIC statements to their machine language 
equivalents. 

If you not interested in programming and only 
want to use the burst routines in your own programs 
then I suggest that you check out the sample burst 
routine files on your 1581 Demo/Utilities disk. 

Another thing I might mention is that all burst 
commands use track and sector parameters that refer 
to physical disk locations. The only exceptions to 
this rule are the burst READ and WRITE commands. 
These commands allow you to chose between logical or 
physical disk translation. 

The burst protocol handshake is outlined on page 
99 of the 1581 User's Guide. Study it and the machine 
language source files on the demo disk. They will 
help you to understand the handshaking being used on 
the fast serial bus. Also, it might not be a bad idea 
if you read chapters nine and ten in the 1581 User's 
Guide. 
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Chapter 4 - Burst Uti lity comm ands 


The following commands are new additions to the 
Commodore DOS world. They are all executed via the 
command channel (#15) and are listed and explained 
below. These commands are explained using my 
interpretation of what they do. Unfortunately, 
Commodore did not document these commands in the 1581 
manual. This was a glaring omission in an otherwise 
perfect drive manual. 

_ S _e.r ial _ gus JM[ pd e_ 

The serial bus mode command tells the 1581 to 
use fast or slow serial transfers to and from the 
computer. 

The command takes the form: 

PRINT#15, "UO>Bx" 

where "x" equals one for fast serial and zero 
for slow serial. Apparently this command was added to 
turn burst mode on and off when using the C128 with 
the 1581. It does not seem to effect C64 usage. 

_DQSSector interleave- 

This command controls the number of sectors 
between each linked block on a disk. The default 
value is one on power up. This value makes the drive 
very fast when accessing disk data. 

Increasing it's value would make the drive run a 
little slower since it would have to search a little 
further for data from block to block. 

The command takes the form: 

PRINT#15, M UO>Sx M 

where "x" equals a value from 0 to 255. I see no 
real reason for having this command and recommend 
that you leave the interleave set to one on the 1581. 

For comparison the 1541 and 1571 (C128 mode) 
have normal sector interleave rates of ten and six 
respectively. You may also find that some folks use 
the term "skew rate" or just "skew. " These terms of 
synonymous with sector interleave. 
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This command allows you to select the number of 
read attempts that the DOS tries on bad sectors. The 
default value is two on power up. 

The command takes the form: 

PRINT#15,"U0>Rx" 

where "x" is a value from 0 to 255. A value of 
zero tells the drive to not try and read the bad 
sector again, but to just except it as a bad one. 
When "x" has a value from 1 to 255 the DOS will try 
to reread a sector "x" times. Once again I recommend 
that you leave this value at it's default of two. 

One note of interest about this command is that 
in the 1541 the number of retries could be changed to 
prevent head banging on 1541 protected diskettes. 
That opens the possibilities of using the same trick 
on the 1581, but I have not found reason to do that 
yet since there are no copy protected 1581 disks out 
there. 

Also increasing the value will often allow you 
to recover data from a damaged sector. But, beware, 
over working the drive might wear the drive 
mechanism. 


ROM Signature Analysis 

The 1581 DOS provides a means of extensively 
testing the ROMs in the drive, simply issue the 
following command: 

PRINT#15, ,, UO>T w 

The drive will now test your 1581 's ROM. If a 
failure in the ROM is detected the LED's will blink 
continuously in a four blink pattern. 

Verify Select 

This command is used to turn the 1581's verify 
mode on and off. During writing this command will 
control whether or not the drive verity's the data 
that is written to the diskette. 

The command takes the form: 

PRINT#15,"U0>Vx" 
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where "x" equals one for verify off and zero for 
verify on. 

I recommend the usage of this command when using 
the disk drive for important work. It's a fact that 
using verify mode certainly cannot hurt anything. 
However, it might slow the drive up a little since 
verifying data takes a little extra time. 

One important thing to remember is DON'T PANIC! 
Your 1581 will prove to be a very reliable device 
when reading and writing to diskettes. I find however 
that repeated writing and reading to a diskette seems 
to invite errors more and more often. I suggest that 
people using the 1581 on BBSes or as a work drive 
always turn verify mode on. 

Select 

Although the 1581 provides easy access to 
changing the device number settings (via DIP 
switches), it can often easier to change the device 
number through software. Commodore made software 
device changes possible with the following command: 

PRINT#15 , ,, U0>” +CHR$ ( X) 

where "x" represents a device number from four 
to thirty. Standard disk drive devices are numbered 
eight through eleven. 

Any device number changes made with this command 
are not permanent or used as the default. If you want 
a device number to be the default the best way to 
accomplish this is to read the section in your 1581 
manual on hardware device setting. This appears on 
page 111 of the 1581 User's Guide. 

Mystery Co wman^ - SIEEE Timing 

The 1581 also provides an undocumented utility 
command for which I could find only one use. This 
command takes the form of: 

PRINT#15, ,, UO>Ix” 

where "x" can be any value from zero to 255. 

This command controls the disk drive's SIEEE 
timing value. The SIEEE timing value is stored at 
$9D/157. On reset this value is set to $20/32 by a 
routine at $B091. This command may have had something 
to do with a now nonexistant IEEE interface for the 
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Burst Memory Read/Write 

Burst memory read and write use the standard 
burst protocol with no status byte. They take the 
form of: 

PRINT# 15 , ,, UO>MR ,, +CHR$ ( >MEMADDR) +CHR$ ( # OF PAGES) 

OR 

PRINT# 15 , ,, UO>MW ,, +CHR$ ( >MEMADDR)+CHR$ ( # OF PAGES) 

These commands are for C128 users only and files 
showing how they work can be found on the 1581 
Demo/Utilities disk. As well as files allowing you to 
access the 1581's burst protocol features. 
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Chapter 5 - Using Kracker-Mon 
Exploring the 1581, a Hew Frontier, 

Now you to can be a brave 1581 explorer and 
discover new worlds within your 1581 disk drive. A 
vast frontier of new DOS routines and functions are 
now available for exploration and discovery in the 
1581 disk drive. The utility described in this 
chapter will be your vehicle to discovery. 

Kracker-Mon is an all purpose machine language 
monitor (MLM) with many features including but not 
limited to: 

Kracker-Mon Relocator 
Op-Code Editor 
Computer MLM 
Drive-Mon 
DOS Wedge 

The program and documentation were provided 
courtesy of KRACKER JAX, a division of Software 
Support International. Kracker-Mon was written by 
Mike Howard. Thanks guys for this wonderful tooli 

DOS in the Dumps 

For your convenience I have provided a program 
in Appendix A that will dump a copy of the 1581's 32K 
ROM operation system onto a diskette so that you can 
explore the DOS with other tools such as 
disassemblers, etc. 

Simply key in the program called DOS DUMP, save 
it to a blank disk in your 1581 disk drive. Proofread 
it before execution and if everything's ok run it. 

After running DOS DUMP it will prompt you for 
the source drive (where it reads the ROM) and the 

destination disk (where it wants to put the DOS 

file). This program is not extremely fast so go read 
a book or whatever for a few minutes. 

The program is compatible with the 1571 also and 

will dump a copy of the DOS on a C64 or C128. It does 

not use burst routines, since they are not C64 
compatible. If you choose to you can use Kracker-Mon 
to dump the DOS, but doing 32K of ROM that way is 
slow and tedious. Sit back and let the computer do it 
using DOS DUMP. Put that computer to work folks! 
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How do you do that Kracker-Mon? 

The following documentation for Kracker-Mon 
covers program operation only. If you have purchased 
this book with it's companion disk please refer to 
Appendix A for information on how to load Kracker- 
Mon. 


Kracker-Mon is completely relocatable in memory. 
The + and - keys will increment and decrement the 
monitor address. Hitting the RETURN key while the 
"Monitor^XOOO" is highlighted will also increment 
the monitor. 


FI 

F3 

RESTORE 
Option 1 
Option 2 
Option 3 


- Directory of disk in drive. 

- Exit Kracker-Mon, enter BASIC 

- Restart program to beginning menu 

- Execute the chosen monitor 

- Save chosen monitor to a WORK DISK 

- Edit the opcode file called OPS on 

any WORK DISK. 

w o .t g JB L -QinL. flptAon 3 


Selecting option 2 saves the following 
information onto a WORK DISK: 


Autoboot filename - "MONXOOO" 
Opcode listings - "OPS” 
Monitor - "XO" 

Execute a saved monitor via: 


LOAD "MONXOOO M ,8,1 
It will now load and execute itself. 

Hot^ .s_oo_Op_t i _On_3_ 

CURSOR U/D - Slow scroll through the list 
CURSOR R/L - Fast scroll through the list 
RESTORE - Reset to previous menu 
SPACE BAR - Allows you to change the mnemonic 
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A - Steps through the addressing inodes 

(changes them) 

HOME - Returns cursor to beginning ($00 

byte) 

S - Saves changed opcode file to WORK 

DISK 


Note: Old opcode file is overwritten so be sure 
that you do not overwrite an OPS file that you need 
my mistake. Rename the old file or use another WORK 
DISK. NEVER save anything to the companion diskette! 

Kracker-lfon gQBEMBdS 


Com ma nd 

R 


G xxxx 


Displays status of A, X, and 
Y registers stack pointer 
and program counter. 

Executes code starting at 
$xxxx 


Returns user to BASIC. 


M FFFF LLLL Displays in hex and ASCII 

memory between the two 
addresses. If the second 
address is not specified, 
scrolls forever. RUN/STOP 
halts. 


@ Send a DOS command. I used 

alone returns the drive 
status. @$ gives a disk 
directory. Space pauses the 
directory and stop aborts. 

L Load file from disk into 

memory. 

L "FILENAME",device#,address(optional) 


If an address is given the 
program loads at that 
memory address. 

V Verify file in memory with 

one on disk. Same format as 
load command. "?" stands 
for verify error. 
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V "FILENAME",device#,address(optional) 

S Save file in memory to disk. 

S "FILENAME",device#,FFFF,LLLL+1 

Example: S "FILE",08,0000,0000 
saves memory from $C000-$CFFF 

F FFFF LLLL XX Fills memory from $FFFF to 
$LLLL with $XX byte value. 

D FFFF LLLL Disassembles memory. You can 
use the cursor U/D keys to 
scroll through the 
disassembly. If the LLLL 
parameter is not specified 
one page of disassembly is 
printed instead of a range 
of memory. 

P Send code to printer. 

PD FFFF LLLL sends 
disassembly to the 
printer. 

PM FFFF LLLL sends hex 
memory listing to the 
printer. 

(1525 compatible printers 
only!) 

A xxxx Assemble mnemonic commands. 

Assembles code beginning at 
$xxxx (Be sure to use 
proper spacing between 
characters.) 

H FFFF LLLL PP Hunts from $FFFF to $LLLL 
for up to an eight byte 
pattern (PP). Use single 
quotes around ASCII test to 
hunt for ASCII text. ASCII 
and HEX may be mixed. 

Examples: 

H E000 FFFF 9 COMMODORE' 

H E000 FFFF 43 4F 4D 4D 
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H EOOO FFFF 43 4F 'MM 


T Transfers memory from $FFFF 

to $LLLL to $xxxx. 

Examples: 

T FFFF LLLL XXXX 

T EOOO FFFF 1000 

TC Same syntax as T command. 

Will transfer computer 
memory to drive. 

TD Same syntax as T command. 

Will transfer drive memory 
to the computer. 

TF Same syntax as T command. 

Fast command version of TC. 
Warning! $xxxx cannot be 
between $0001 and $0147. 
NOT 1581 COMPATIBLE! 

O This is the letter O, not 

zero. O followed by an 8, 
9, A, or B (device number) 
will out you in the Drive- 
Mon mode for the specified 
drive. The above commands 
are the same for the Drive- 
Mon except the P feature is 
disabled. 

For printer listings of 
drive memory, send the code 
to the computer , then the 
printer. O and RETURN sends 
you back to the computer 
memory. A "] M lets you know 
your in drive memory, while 
a 11 . ” denotes computer 
memory. 

To assemble/disassemble beneath the ROMs and the 
VIC CHIP, change location $0002 as if it were $0001. 
$0001 cannot be changed through the monitor. 

$0002: $37 All ROMs in 

$36 Bank out BASIC ($A000-$BFFF) 
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$35 Bank out KERNAL and BASIC 
($AOOO-$BFFF and $E000- 
$FFFF) 

$30 Bank in RAM under $D000 

$31 Bank in character ROM under 
$D000 
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Chapter 6 - System Overview and RAM Memory Maps 

$0000-$lFFF 8K of RAM memory 


$0000-$00FF Zero page variables 

$0100-$0 IFF Vectors, variables, and 
stack area 


$0200-$0BFF DOS data buffers 
$0C00-$1FFF Track cache buffer 


$4000-$400F Serial bus I/O 

controller 8520A 2 Mhz 

CIA chip 

$6000-$6003 MFM Floppy disk 

controller WD177x 
series chip 

$8000-$FFFF 32K of DOS in ROM containing 

1581 controller routines 
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u 

u 

u 

u 

u 

u 

u 

u 

w 

u 

u 

u 




LOCATION 

LABEL 


n 

$0000-$0001 

RAMTST 

r 

$OOO2-$0OOA 

JOBS 



JOBO 

n 


JOB1 

O 


JOB2 

JOB 3 






JOB4 

r\ 

r*\ 


JOB5 

JOB6 




n 


JOB7 

n 





J0B8 

n\ 




$000B-$001C 

HDRS 

n 


TSJO 

o 




n 


TSJ1 

n 

n 


TSJ2 



TSJ3 


r\ 

n 

r\ 


TSJ4 

TSJ5 

n 


TSJ6 


DESCRIPTION 


POINTER USED BY RAM AND ROM 
TESTS 


JOB QUEUE 

FOR JOBS 

0 TO 8 

$0002 

BUFFER 

0 

AT 

$0300 

$0003 

BUFFER 

1 

AT 

$0400 

$0004 

BUFFER 

2 

AT 

$0500 

$0005 

BUFFER 

3 

AT 

$0600 

$0006 

BUFFER 

4 

AT 

$0700 

$0007 

BUFFER 

5 

AT 

$0800 

$0008 

BUFFER 

6 

AT 

$0900 

$0009 

BUFFER 7 
(BAM 0) 

AT 

$0A00 

$000A 

BUFFER 

8 

AT 

$0B00 


(BAM 1) 


TRACK AND SECTORS FOR JOBS 
LISTED ABOVE 


$000B, 

$000C 

TRACK 

AND 

SECTOR 

JOB 0 



$000D, 

$000E 

TRACK 

AND 

SECTOR 

JOB 1 



$000F, 

$0010 

TRACK 

AND 

SECTOR 

JOB 2 



$0011, 

$0012 

TRACK 

AND 

SECTOR 

JOB 3 



$0013 , 

$0014 

TRACK 

AND 

SECTOR 

JOB 4 



$0015, 

$0016 

TRACK 

AND 

SECTOR 

JOB 5 



$0017 , 

$0018 

TRACK 

AND 

SECTOR 

JOB 6 




r\ 

O 
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LOCATION _LAftJEL_ 


DESCRIPTION 


TSJ7 

TSJ8 

$001D-$001E DSKID 

$00IF- HEADER 

$ 0021 - 
$ 0022 - 


$0025- WPSW 

$0026- DRVST 


$0027- DRVTRK 


$0019, 

$001A 

TRACK 

AND 

SECTOR 

JOB 7 



$001B, 

$001C 

TRACK 

AND 

SECTOR 

JOB 8 




MASTER COPY OF DISK ID 
PHYSICAL TRACK NUMBER 
PHYSICAL SECTOR NUMBER 


PHYSICAL SECTOR LENGTH (2 = 
512 BYTES FOR THE 1581) 


0 = 

128 

SECTOR 

BYTES 

IN 

THE 

1 = 

256 

SECTOR 

BYTES 

IN 

THE 

2 = 

512 

SECTOR 

BYTES IN 
(NORMAL) 

THE 

3 = 

1024 

SECTOR 

BYTES 

IN 

THE 

WRITE 

PROTECT 

CHANGE 

FLAG 


LCC VARIABLE 
7654 3210 

i i i i 

j J | -> TIMEOUT 

I -> RUNNING 

j -> STEPPING 

-> ACCELERATING 

$00 NO DRIVE ACTIVE 

$20 DRIVE IS RUNNING 

$30 RUNNING AND TIMEOUT 

$50 STEPPING / RUNNING 

$80 ACCELERATING 

CURRENT PHYSICAL TRACK BEING 
ACCESSED 
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vj 
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VJ 

VJ 
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VJ 

VJ 

vj 

VJ 

VJ 

vJ 

VJ 

u 

VJ 






o 

r\ 

p 

LOCATION 

LABEL 




o 

rs 

$0028- 

CMD 

r\ 

$0029- 

CMDSIZ 

r 

$002A-$002B 

ACLTIM 

r 

n 

$002C- 

SAVSP 

o 

$002D- 

AUTOFG 

rs 

$002E- 

SECINC 


$002F- 

FREBLK 

r\ 

rs 

$0030- 

REVCNT 

r 

$0031-$0032 

BMPNT 

O 

n 

$0033-$0034 

USRJMP 

n 

$0035- 

WBAM 

rs 

$0036-$0037 

CTMP 

r ^ 

n 

$0038-$003E 

TMP 

r\ 

$003F- 

TMPJBN 

o 

$0040- 

TO 

n 

r 

$0041- 

T1 

rs 

$0042- 

T2 

rs 

r 

$0043- 

T3 

n 

$0044- 

T4 

rs 

n 

$0046-$004B 

IP 




DESCRIPTION 

TEMP COMMAND JOB 

COMMAND STRING SIZE 

ACCELERATION TIME DELAY 

SAVE STACK POINTER 

AUTO INITIALIZE FLAG 

SECTOR INTERLEAVE FOR SEQ 
(SET ON RESET $01) 

FREE BLOCKS COUNTER 

ERROR RECOVERY COUNT (SET ON 
RESET TO $02) 

BIT MAP POINTER (SET ON 
RESET TO $0000) 

USER JUMP TABLE POINTER (SET 
ON POWER UP OR RESET TO 
$FFEA) 

BAM STATUS FLAG (0 = CLEAN) 
TEMPORARY WORK AREA 
TEMPORARY WORK AREA 
TEMPORARY JOB NUMBER 

TEMPORARY WORK AREA ($0040- 
$0044) 


INDIRECT POINTER VARIABLE 
(SET TO $0100 ON POWERUP OR 
RESET) 

LAST PROGRAM ACCESSED 


^ $004C- PRGTRK 

o 
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U 

LOCATION 

LABEL 

DESCRIPTION 

U 




u 

$004D- 

TRACK 

CURRENT TRACK 

o 

$004E- 

SECTOR 

CURRENT SECTOR 

u 




w 

$004F- 

TOS 

TOP OF STACK 

u 

$0050- 

LINDX 

LOGICAL INDEX 


$0051- 

EOIFLG 

TEMP EOI 

u 




u 

$0052- 

SA 

SECONDARY ADDRESS 

u 

$0053- 

ORGSA 

ORIGIANL SA 

w 

$0054- 

DATA 

TEMPORY DATA BYTE 


$0055- 

R0 







$0056- 

R1 


^J 

$0057- 

R2 

TEMPORARY RESULTS ($0055- 

u 



$0059) 

u 

$0058- 

R3 


u 

$0059- 

R4 


u 




u 

$005A-$005E 

RESULT 

RESULT AREA 


$0060-$0064 

ACCUM 

ACCUMULATOR 

u 

$0065-$0066 

DIRBUF 

DIRECTORY BUFFER $05/$02 





u 

$0067- 

F1PTR 

FILE STREAM 1 POINTER 

u 

$0068- 

RECPTR 

POINTER TO START OF RECORD 

u 

$0069- 

SSNUM 

NUMBER OF SIDE SECTOR 


$006A- 

SSIND 

INDEX TO SIDE SECTOR 

u 



u 

$006B- 

RELPTR 

RELATIVE FILE POINTER TO 

u 



TRACK 




o 

$006C- 

JOBNUM 

CURRENT JOB NUMBER 

u 

$006D- 

BUFUSE 

BUFFER ALLOCATION 

u 








V .J 




<J 

c Copyright 

1988 D. W 

. Martin All Rights Reserved. 
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n 

r*\ 

r -s 
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r\ 

rs 

<~s 
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o 

/~s 

n 
n 
r*s ■ 
O 

r^ 

n 

r\ 

r ^ 

n 

n 



$006E- LSTDRV LAST DRIVE WITHOUT ERROR. 




USED AS THE DEFAULT DRIVE 
NUMBER. ALSO USED AS THE NO 
DRIVE FLAG. 

$006F- 

CDOSVER 

COPY OF DOS VERSION "D" FOR 
COMPARISON 

$0070- 

LINUSE 

LINDX USE WORD 

$0071- 

DIRSEC 

DIRECTORY SECTOR 

$0072- 

DELSEC 

SECTOR OF FIRST AVAILABLE 
ENTRY 

$0073- 

DELIND 

INDEX OF FIRST AVAILABLE 
ENTRY 

$0074- 

LBUSED 

LAST BUFFER USED 

$0075- 

NUMSEC 

WORK AREA FOR FINDING BEST 
SECTOR TO DO/LOGICAL NUMBER 
OF SECTORS 

$0076- 

FSFLAG 

FAST SERIAL FLAG 


7 6 5 4 

3 2 10 


j -> ATN PENDING 

j-> ATN MODE 

[ -> CLKIN STATUS 

j -> FA st LOCK(SERIAL) 

J -> SLOW FLAG 

I -> FAST FLAG(SERIAL) 

j -> LISTEN FLAG 

-> talk FLAG 

$0077- LSNADR LISTENER ADDRESS ($28 ON 

RESET IF 1581 IS SET VIA 

DIP SWITCH TO DEVICE 8) 

$0078- TLKADR TALKER ADDRESS ($48 ON RESET 

IF 1581 IS SET VIA DIP 

SWITCH TO DEVICE 8) 

$0079- LEDPRINT LED VARIABLE 

7654 3210 

j j -,-> BLINK RED LED 

-> ACTIVATE LED 
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u 


LOCATION 

LABEL 

DESCRIPTION 

O 1 




U 

$007A- 

TEMPSA 

TEMPORARY SECONDARY ADDRESS 

u 




u 

$007B- 

CMDWAT 

COMMAND WAITING FLAG 

KJ 

$007C- 

UOCMDNO 

"UO" COMMAND NUMBER 

O 

$007D- 

CTRLST 

CONTROLLER STATUS 

O 

$007E-$007F 

BUFPNT 

BUFFER POINTER 

V .J 




o 

$0080- 

DKMODE 

BURST STATUS 

u 

$0081- 

JOBRTN 

JOB RETURN FLAG 

o 

$0082- 

YREG 

CPU Y REGISTER STORAGE 

o 




^J 

$0083- 

NEXTJOB 

CONTROLLER NEXT JOB 






$0084- 

CINDEX 

CONTROLLER JOB INDEX 

V.J 

$0085-$0086 

INFO 

CONTROLLER JOB INFORMATION 

O 




O 

$0087- 

TCDIRTY 

TRACK CACHE DIRTY FLAG 





o 

$0088- 

CMDTRK 

CONTROLLER DESTINATION TRACK 

o 

$0089- 

DKANDMASK 

BURST STATUS MASK (AND) 

o 

$008A- 

DKORAMASK 

BURST STATUS MASK (ORA) 

O 

$008B-$008C 

CACHE 

POINTER TO BUFFER CACHE 

V_y 



($0C00) 





U 

$008D- 

IOBYTE 

VERIFY / CRC / REL FILE FLAG 

O 


7 6 5 4 

3 2 10 

u 


i i i_ 

1 1 i 

-> REL FILE 

v ) 


II 

l i 

-—> CRC CHECK 



1 

i 

-> VERIFY CHECK 

O 


(NOTE: THIS IS BYTE $06/6 IN THE 

O' 


BAM) 


O 

$008E- 

PSTARTRK 

PHYSICAL STARTING TRACK 

o 




o 

$008F- 

PMAXTRK 

PHYSICAL ENDING TRACK 

o 

$0090- 

STARTRK 

LOGICAL STARTING TRACK 

o 

$0091- 

PSECTRSIZ 

PHYSICAL SECTOR SIZE 

u 




o 
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<J 






n 




n 




n 

LOCATION 

label 

DESCRIPTION 

n 

$0092- 

PNUMSEC 

PHYSICAL NUMBER OF 




SECTORS/SIDE 

n 

$0093- 

PENDSEC 

PHYSICAL ENDING SECTOR 

n 




n 

$0094- 

PSTARTSEC 

PHYSICAL STARTING SECTOR 

n 

$0095- 

CACHETRK 

CURRENT PHYSICAL TRACK CACHE 

n 

$0096- 

TCACHESID 

TRANSLATED CURRENT TRACK 

n 



CACHE SIDE 

ns 

$0097- 

CACHESIDE 

CURRENT TRACK CACHE SIDE 

ns 




n 

$0098- 

SETVAL 

SETTLING TIME VALUE 

n 

$0099- 

HDRJOB 

SHIFTED NEXT JOB / HEADER 

n 



POINTER 

n 

$009A- 

GAP 3 

FORMAT GAP 

n 

$009B- 

FILLBYTE 

FORMAT FILL BYTE 

n 

$009C- 

SIEEETIM 

SIEEE TIMING COUNTER 

n 




n 

$009D- 

SIEEESET 

SIEEE TIMING VALUE 

n 

$009E- 

BLINK 

ERROR BLINKING COUNTER 

n 

$009F-$00A7 

CACHEOFF 

OFFSET INTO THE TRACK CACHE 

n 



BUFFER (1 BYTE PER JOB) 

n 

$00A8-$00BA 

LINTAB 

SA:LINDX TABLE 

n 

n 



THIS TABLE INDICATES THE 
CURRENT STATUS OF EACH DATA 
CHANNEL (SECONDARY ADDRESS) 

n 



n 



EACH POSITION REPRESENTS 



ONE CHANNEL: 

n 




n 



CHANNEL 0 = $00A8 

n 



CHANNEL 1 = $00A9 

n 



ETC. 

n 




n 




n 




n 




n 




n 
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LOCATION 


LABEL 


$OOBB-$OODO BUFTAB 


$00D1-$00D7 BUFO 







o 


DESCRIPTION 

u 



u 

POSSIBLE 

CHANNEL STATUS 

u 

VALUES ARE: 

u 

$FF - INACTIVE 

VJ 

$81 - OPEN 

FOR WRITE 

L I 

$41 - READ/WRITE 


$01 - OPEN 

FOR READ 

u 

BUFFER BYTE 

POINTERS 

o 



u 

THESE POINTERS FOR EACH 


BUFFER ARE 

USED TO POINT AT 

w 

THE NEXT BYTE IN THE BUFFER 

u 

TO BE USED. THE "B-P" 


COMMAND 

SETS THESE 


POINTERS. 


u 

$00BB-$00BC 

BUFFER #0($0300) 


$00BD-$00BE 

BUFFER #1($0400) 

KJ 




$00BF-$00C0 

BUFFER #2($0500) 


$00C1-$00C2 

BUFFER #3($0600) 

o 

$00C3-$00C4 

BUFFER #4($0700) 

o 



o 

$00C5-$00C6 

BUFFER #5($0800) 

w 

$00C7-$00C8 

BUFFER #6($0900) 

o 

$00C9-$00CA 

BUFFER #7($0A00) 

<sj 


BAM 0 

u 

$00CB-$00CC 

BUFFER #8($0B00) 

u 


BAM 1 

u 

$00CD-$00CE CMD BUFFER 

VJ 


($0200) 

VsJ 

$00CF-$00D0 ERR BUFFER 

u 


($02D0) 


TABLE OF 

CHANNEL NUMBERS 


ASSIGNED TO EACH OF THE 

o 

BUFFERS. 

$FF = INACTIVE 


BUFFER 





o 



u 
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LOCATION LABEL 


$00D8-$00DE BUF1 

r*\ 
r ^ 




r\ 

$00DF-$00E3 

LRUTBL 

O 

$00E4- 

RELPTR 

r*s 



n 

$00E5-$00E9 

ENTSEC 


$00EA-$00EE 

ENTIND 




r\ 

$00EF-$00F3 

FILDRV 

fs 




$00F4-$00F8 

PATTYP 

r\ 



r\ 

$00F9-$00FE 

FILTYP 

r*\ 

$0100- 

STACK 

rs 

$0101- 

RELVAR 

n 




$0102- 

MARKSIDE 


$0104- 

BRKJMP 

r\ 



r\ 

$0109- 

SIDTRK 

n 



o 

$0110- 

SIDSEC 





$0190-$01BB 

SVECTS 




r^s 



r> 

$0190-$0191 

VIDLE 

n 

$0192-$0193 

VIRQ 





$0194-$0195 

VNMI 


$0196-$0197 

WERDIR 


r\ 


DESCRIPTION 


TABLE OF CHANNEL NUMBERS 
ASSIGNED TO EACH OF THE 
BUFFERS. $FF = INACTIVE 
BUFFER 

LEAST RECENTLY USED TABLE 

RELATIVE FILE POINTER TO 
TRACK 

SECTOR OF DIRECTORY ENTRIES 

INDEX OF DIRECTORY ENTRIES 

DEFAULT FLAG, DRIVE NUMBER 
(ALL 0 ON 1581) 

PATTERN, REPLACE, CLOSED 
FLAGS, TYPE 

CHANNEL FILE TYPE 

START OF DRIVE STACK AREA 

VARIABLE FOR RELATIVE FILES 
($ 0100 -$ 0110 ) 

MARK SIDE SECTOR AS 

JUMP TO CONTROLLER ROUTINE 
VIA "BRK" 

SIDE SECTOR TRACK 
INFORMATION 

SIDE SECTOR SECTOR 
INFORMATION 

JUMP TABLE OF MAJOR DOS 
ROUTINES EXECUTE VIA JSR 
($XXXX) 

INDIRECT FOR IDLE 

INDIRECT FOR IRQ 

INDIRECT FOR NMI 

VALIDATE COMMAND 
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U 




U 

$0198-$0199 

VINTDRV 

INITIALIZE COMMAND 

u 

$019A-$019B 

VP ART 

PARTITION COMMAND 

u 




u 

$019C-$019D 

VMEM 

MEMORY READ/WRITE COMMANDS 

u 

$019E-$019F 

VBLOCK 

BLOCK COMMANDS 


$01A0-$01A1 

VUSER 

USER COMMANDS 





u 

$01A2-$01A3 

VRECORD 

RECORD COMMAND FOR REL FILES 


$01A4-$01A5 

VUTLODR 

UTILITY LOADER COMMAND 


$01A6-$01A7 

VDSKCPY 

COPY COMMAND 

k J 

$01A8-$01A9 

VRENAME 

RENAME COMMAND 





U 

$01AA-$01AB 

VSCRTCH 

SCRATCH COMMAND 

u 

$01AC-$01AD 

VNEW 

NEW COMMAND (FORMAT DISK) 

o 

$01AE-$01AF 

VERROR 

CONTROLLER ERROR HANDLER 

u 




u 

$01B0-$01B1 

VATNSRV 

ATN SERVER FOR SERIAL BUS 

o 

$01B2-$01B3 

VTALK 

TALK ROUTINE FOR SERIAL BUS 

u 

$01B4-$01B5 

VLISTEN 

LISTEN ROUTINE FOR SERIAL 

VJ 



BUS 

u 

$01B6-$01B7 

VLCC 

DISK CONTROLLER ROUTINE 





u 

$01B8-$01B9 

VTRANS TS TRANSLATES LOGICAL SECTORS 

! 1 



TO PHYSICAL SECTORS 






$01BA-$01BB 

VCMDERR 

DOS ERROR HANDLER 

VJ 

$01BC-$01CD 

HDRS2 

CONTAINS THE TRANSLATED 

Vj 



PHYSICAL TRACK AND SECTOR 




FOR EACH OF THE JOBS IN THE 




JOB QUEUE (JOBS 0 TO 8, 2 

KJ 



BYTES FOR EACH JOB) 






$01CE-$01D6 

SIDS 

CONTAINS THE PHYSICAL SIDE 

o 



FOR EACH OF THE JOBS IN THE 




JOB QUEUE ( JOBS 0 TO 8, 1 




BYTE FOR EACH JOB) 

u 




u 




O 1 

° Copyright 1988 D. W 

. Martin All Rights Reserved. 

o 

The 1581 DOS 

Reference 

Guide -51- Chapter 6 

u 


u 








LOCATION 

LABEL 

DESCRIPTION 





o 

$01D7- 

CTLTIMH 

CONTROLLER TIMER VARIABLE 

r*\ 



HIGH 


$01D8- 

CTLTIML 

CONTROLLER TIMER VARIABLE 




LOW 

o 

$01D9- 

MOTORACC 

ACCELERATION STARTUP 

n 




rt 

$01DA-$01E4 

WDCMDS 

WD177X CONTROLLER COMMANDS 



(SEE CHAPTER 7) 

n 





$01DA- 

WDRESTORE 

$08 

r ^ 

$01DB- 

WDSEEK 

$18 


$01DC- 

WDSTEP 

$28 

rs 

$01DD- 

WDSTEPIN 

$48 

n 

$01DE- 

WDSTEPOUT 

$68 

r\ 

$01DF- 

WDREADSECTOR $88 


$01E0- 




WDWRITESECTOR $AA 






$01E1- 

WDREADADDRESS $C8 


$01E2- 

HDREAOTRACK $E8 

/-N 

$01E3— 

WDWRITETRACK $FA 






$01E4- 

WDFORCEIRQ $D0 


$01E5- 

DIRST 

STARTING DIRECTORY SECTOR 

o 

$01E6-$01E9 

SAVECTS 

SAVE AREA FOR VECTORS 






$01EA- 

BURSTST 

BURST CONTROLLER STATUS 

Oi 

$01EB- 

VERNUM 

DOS VERSION NUMBER 

r*\ 

$01EC- 

DOSTYP 

DOS TYPE 

r\ 

$01ED- 

PARTHI 

HIGH PARTITION COUNT 

n 



n 

$01EE- 

PARTLO 

LOW PARTITION COUNT 

n 

$01EF- 

MINSEK 

BURST MINIMUM SECTOR NUMBER 

n 

$01F0- 

MAXSEK 

BURST MAXIMUM SECTOR NUMBER 


r\ 
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$01F1-$01F9 BUFIND BUFFER INDIRECTS 

$01FA- WPSTAT WRITE PROTECT STATUS 

$00 - NOT PROTECTED 
$08 - PROTECTED 


$01FB- 

DEJAVU 

AUTOBOOT FLAGS 


7 6 5 4 

i i 

3 2 10 


i i_> 

!-i—> 

BOOT ON INITDRV 

BOOT ON RESET 

$01FC-$01FE 

FLOAD 

EXECUTE BURST FAST LOAD VIA 
JSR $01FC OR JMP $01FC 
CONTAINS: JMP $BA40 

$0200-$0229 

CMDBUF 

COMMAND BUFFER 

$022A- 

CMDNUM 

COMMAND NUMBER 

$022B- 

DIRTRK 

SYSTEM TRACK ($28) 

$022C- 

MAXTRK 

MAXIMUM TRACK + 1 ($51) 

$022D- 

TYPE 

ACTIVE FILE TYPE 

$022E- 

F1CNT 

FILE STREAM 1 COUNT 

$022F- 

F2CNT 

FILE STREAM 2 COUNT 

$0230- 

F2PTR 

FILE STREAM 2 POINTER 

$0231- 

FILCNT 

COUNTER, FILE ENTRIES' 

$0232- 

INDEX 

CURRENT INDEX IN BUFFER 

$0233- 

TYPFLG 

MATCH BY TYPE FLAG 

$0234-$023A 

CHNRDY 

CHANNEL STATUS 

$023B-$0241 

CHNDAT 

CHANNEL DATA BYTE 

$0242-$0248 

LSTCHR 

CHANNEL LAST CHARACTER 
POINTER 

$0249-$024F 

RECL 

TABLE OF LOW BYTES OF RECORD 
NUMBERS FOR EACH BUFFER 
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u 

u 

u 

u 

u 

u 

o 1 

o 

u 

^J 

u 

u 

o 

vj 

o 

o 

o 

o 

»sj 

u 

vJ 

u 

u 

^sJ 

•s-> 

u 

u 

o 

u 

O' 

o 

u 

o 







rs 



rs 

LOCATION 

LABEL 

rs 


rs 

$0250-$0256 

RECH 

rs 



rS 



O 

$0257-$025D 

NR 

rs 



rs 

$025E-$0264 

RS 

r\ 

rs 

$0265-$026B 

SS 

rs 

$026C- 

STRSIZ 

rs 



rs 

$026D- 

ENTFND 

rs 

$026E- 

DIRLST 

rs 

$026F- 

REC 

rs 



rs 

$0270- 

TRKSS 

rs 



rs 

$0271- 

SECSS 

rs 



rs 

$0272-$027C 

LSTJOB 

rs 



rs 

$027D-$0283 

DSEC 

rs 



rs 

$0284-$028A 

DIND 

rs 

$028B- 

PRGSEC 

rs 

$028C- 

WLINDX 

rs i 

$028D-$028E 

NBTEMP 

rs 



rs 

$028F- 

CHAR 

rs 

$0290- 

LIMIT 

rs, 

$0291-$0296 

FILTBL 




rs 

$0297-$029B 

FILTRK 

rs 




DESCRIPTION 


TABLE OF HIGH BYTES OF 
RECORD NUMBERS FOR EACH 
BUFFER 

TABLE OF NEXT RECORD NUMBER 
FOR BUFFERS 


TABLE OF RECORD SIZE FOR 
EACH BUFFER 

TABLE OF SIDE SECTORS FOR 
EACH BUFFER 

LENGTH OF THE STRING 

DIRECTORY ENTRY FOUND FLAG 

DIRECTORY LISTING FLAG 

RECORD SIZE USED BY 
DIRECTORY ROUTINES 

SIDE SECTOR TRACK USED BY 
DIRECTORY ROUTINES 

SIDE SECTOR SECTOR USED BY 
DIRECTORY ROUTINES 

LAST JOB BY BUFFER 

SECTOR OF DIRECTORY ENTRY BY 
BUFFER 

INDEX OF DIRECTORY ENTRY BY 
BUFFER 

LAST PROGRAM SECTOR 
WRITE LINDX 

NUMBER OF BLOCKS TEMPORARY 
CHARACTER UNDER THE PARSER 
PTR LIMIT IN COMPARISON 
TABLE OF FILENAME POINTERS 
FIRST FILE LINK (TRACK) 
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u 

u 


o 

H 

Ej 

_LABEL_ 

DESCRIPTION 

U 

$029C-$02A0 

FILSEC 

FIRST FILE LINK (SECTOR) 

U 



u 

$02A1- 

PATFLG 

PATTERN PRESENT FLAG 

u 

$02A2- 

IMAGE 

FILE STREAM IMAGE 

u 

$02A3- 

DRVCNT 

NUMBER OF DRIVE SEARCHES 

u 




o 

$02A4- 

DRVFLG 

DRIVE SEARCH FLAG 

u 

$02A5- 

FOUND 

FOUND FLAG IN DIRECTORY 




SEARCHES 


$02A6- 



u 

LSTBUF 

EQUALS 0 IF LAST BLOCK 


$02A7- 

MODE 

ACTIVE FILE MODE (R, W) 

u 

$02A8- 

JOBRTN 

JOB RETURN FLAG 

u 






7 6 5 4 

1 1 

1 | 

3 2 10 

u 


i i — > 

SKIP TRK & SEC CHECK 

u 



RETURN ON ERROR 




VJ 

$02A9- 

NDBL 

NUMBER OF DISK BLOCKS FREE 

o 



LOW 




u 

$02AA- 

NDBH 

NUMBER OF DISK BLOCKS FREE 

o 



HIGH 




u 

$02AB- 

ERWORD 

ERROR WORD ON RECOVERY 

VJ 

$02AC-$02CF 

NAMBUF 

DIRECTORY BUFFER 


$02D0-$02F4 

ERRBUF 

ERROR MESSAGE BUFFER 

u 




u 

$0300-$03FF 

BUFFO 

DATA BUFFER #0 

u 

$0400-$04FF 

BUFFI 

DATA BUFFER #1 

u 

$0500-$05FF 

BUFF2 

DATA BUFFER #2 

u 





$0600-$06FF 

BUFF 3 

DATA BUFFER #3 

o 

$0700-$07FF 

BUFF 4 

DATA BUFFER #4 

u 

$0800-$08FF 

BUFF 5 

DATA BUFFER #5 

u 




u 

$0900-$09FF 

BUFF6 

DATA BUFFER #6 

u 




o 
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r\ 

n 

rs 

r 

r 

r 

r\ 

rs 

r 

r 

n 

n 

r 

n 

n 

rs 

r 

r> 

n 

n 

rs 

r\ 

n 

r\ 

r> 

rs 

r 

o 

n 

n 

rs 

n 

rs 

rs 

r 

r 

r 


LOCATXOM_ -LAB EL- PESCRICT IQ JL . 

$OAOO-$OAFF BAM1 BAM FOR TRACKS 1 TO 40 

$0B00-$0BFF BAM2 BAM FOR TRACKS 41 TO 80 

$0C00-$1FFF BUFCACHE TRACK CACHE BUFFER (20 

PAGES) 
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Cixapfcer, 7 - DOS C optro 3. 1 er_Chips Memory Map O 


Serial 1/0 8520A 

f$4000-$400F) 

U 





U 

^LOCATION 


BIT 

DESCRIPTION 


$4000 


0-7 

DATA PORT A (FLOPPY 
DISK CONTROLLER I/O) 

u 




u 


DSKCH 

7 

DISK FLAG (1 = PRESENT) 

o 


ACTLED 

6 

GREEN LED (1 = ON) 

o 


ERRLED 

5 

RED LED (1 = BRIGHT) 








DEVSW1 

4 

DEVICE SWITCH 1 (LEFT) 

u 


DEVSW2 

3 

DEVICE SWITCH 2 (RIGHT) 



MOTOR 

2 

0 = MOTOR ON/1 = MOTOR 

kJ 




OFF 

u 


DRVRDY 

1 

DRIVE READY (1 = DRV 





READY) 

u 


SIDE 

0 

0 = SIDE 0/1 = SIDE 1 

u 





VJ 



* * 

* 

u 

$4001 

( 

3—7 

DATA PORT B (SERIAL 
DATA I/O) 

u 




u 


ATNIN 

7 

ATTENTION IN LINE 

u 


WRTPRO 

6 

WRITE PROTECT (1 = 





WRITE ENABLE/0 = WRITE 
PROTECTED) 

o 







BUSDIR 

5 

1581 BUS DATA DIRECTION 

o 




(0 = INPUT/1 = OUTPUT) 





o 


ATNACK 

4 

ATTENTI ON ACKNOWLEDGE 

u 




LINE 





u 


CLKOUT 

3 

CLOCK OUT LINE 



CLKIN 

2 

CLOCK IN LINE 

^J 


DATOUT 

1 

DATA OUT LINE 

u 





u 


DATAIN 

0 

DATA IN LINE 

u 

$4002 

DDA 0-7 

DATA DIRECTION PORT A 

u 


_ O 
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n 

LOCATION 


BIT 

DESCRIPTION 

$4003 

DDB 

0 

1 

V] 

DATA DIRECTION PORT B 

n 

$4004 

TAL 

0-7 

TIMER A LOW/BAUD RATE 





LOW 

n 

$4005 

TAH 

0-7 

TIMER A HIGH/BAUD RATE 

r*s 




HIGH 

r*\ 

$4006 

TBL 

0-7 

TIMER B LOW/CTRLER IRQ 

n 






$4007 

TBH 

0-7 

TIMER B HIGH/CTRLER IRQ 


$4008 

SEC 

0-7 

USED FOR DISK CHANGE 





DETECTOR 


$400C 

SDR 

0-7 

SERIAL DATA REGISTER 

n 

$4000 

ICR 

0-7 

INTERRUPT CONTROL 

n 




REGISTER 

n 

$400E 

CRA 

0-7 

CONTROL REGISTER A 


$400F 

CRB 

0-7 

CONTROL REGISTER B 

n 



* * * 







r ^ 

WD177X Floppy Disk Controller 

r> 

LOCATION 

READ 

FUNCTION 

WRITE FUNCTION 

r^ 





O 

$6000 

STATUS 


COMMAND 


$6001 

TRACK 


TRACK 

/-\ 

$6002 

SECTOR 

SECTOR 

O 





r\ 

$6003 

DATA 


DATA 

n 



* * * 


n 


WD177X Command Summary 





COMMAND VALUE 

0 

TYPE DESCRIPTION 

BIT 76543210 

n 

I RESTORE 


0 0 0 0 H V X Y 

0 





n 

I SEEK 



0001HVXY 

n 

I STEP 



001UHVXY 

r\ 
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TYPE 

I 

I 

II 

II 

III 

III 

III 

IV 


H: 

V: 

X: 

Y: 


U: 

M: 

A: 

E: 


DESCRIPTION 
STEP IN 
STEP OUT 
READ SECTOR 
WRITE SECTOR 
READ ADDRESS 
READ TRACK 
WRITE TRACK 
FORCE INTERRUPT 

_bit_key 


COMMAND VALUE 
BIT 76543210 

010UHVXY 

011UHVXY 

100MHE00 

101MHEPA 

1100HE00 

1110HE00 

1111HEP0 

1101IJKL 


0 = TURN MOTOR ON, 1 = TURN MOTOR OFF 

0 = VERIFY OFF, 1 = VERIFY ON DESTINATION 
TRACK 

STEPPING RATE LOW BIT 
STEPPING RATE HIGH BIT 


WD1772 STEP RATES ARE: 


_JL_ _L_ JBAT JEL 
0 0 2 MS 

0 1 3 MS 

1 0 6 MS 

1 1 12 MS 


SET UP THE TRACK REGISTER TO TRACK FROM 
CURRENT HEADER (0 = NO, 1 = YES) 

0 = READ ONE SECTOR ONLY, 1 = READ MULTIPLE 
SECTORS 


0 = WRITE NORMAL DATA MARK, 1 = WRITE DELETED 
SECTOR MARK (NORMAL MEANS A VALID SECTOR, 
OTHERWISE IT'S ERASED) 

0 = NO HEAD SETTLING TIME, 1 = 30 MS DELAY TO 
SETTLE 
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U 

U 

O 

vj 

o 

u 

o 

V .J 

u 

u 

u 

<J 

o 

u 

o 

u 

u 

u 

v.J 

u 

o 

u 



r\ 

n 

n 
n 
n 

* * * 

DESCRIPTIQN- 
BUSY FLAG 

1 = COMMAND IS UNDER EXECUTION 

0 = NO COMMAND IS EXECUTING 

DATA REQUEST/INDEX 

1 = DATA IS READY IN THE DATA 
REGISTER AT $6003. WHEN READING THIS 
MEANS THAT THE DATA REGISTER IS 
FULL, WHEN WRITING THIS MEANS 
THAT THE DATA REGISTER IS EMPTY. 

0 = ALWAYS RESET TO ZERO WHEN UPDATED 

LOST DATA/TRACK 00 

TYPE 1 COMMANDS: INDICATES THAT THE 
HEAD IS ON TRACK 0, BIT 2=1 

OTHER COMMANDS: INDICATES THAT THE 
DATA IN THE REGISTER AT $6003 WAS 
NOT READ OR WRITTEN IN TIME BY THE 
PROGRAM 

n 

o 
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n 

n 

n\ 

r ^ 

o 

r\ 

r ^ 
n 
n 
o 

r*) 


-BIT. 


P: 0 = ENABLE WRITE PRECOMPENSATION, 1 = DISABLE 
WRITE PRECOMPENSATION 

I thru L are the WD177X controller interrupt 
condition. 

I: DON'T CARE 

J: DON'T CARE 

K: INTERRUPT OCCURS WHEN INDEX HOLE IS 
ENCOUNTERED 

L: IMMEDIATE INTERRUPT REGARDLESS OF CONDITION 

When I thru L are all zero then the current 
command is terminated without an interrupt. 



3 CRC ERROR 

CHECKSUM BYTES OF THE HEADER OR DATA 
BLOCK DECODED IN ERROR (BAD HEADER 
OR DATA) 

4 RECORD NOT FOUND 

SET TO ONE MEANS THAT THE DESIRED 
TRACK, SECTOR, OR SIDE WERE NOT 
FOUND 

5 RECORD TYPE/SPIN-UP 

TYPE 1 COMMANDS: INDICATED THAT THE 
MOTOR SPIN-UP SEQUENCE WAS COMPLETED 

TYPE 2 AND 3 COMMANDS: THIS BIT 
INDICATES THE RECORD TYPE (0 = DATA 
MARK, 1 = DELETED DATA MARK) 

6 WRITE PROTECT 

WHEN SET TO ONE THIS MEANS THAT WRITE 
PROTECT IS ON (WRITE OPERATIONS 
ONLY) AND DISK YOU CANNOT WRITE TO 
THE CURRENT DISKETTE 

7 MOTOR ON 

STATUS OF THE DRIVE MOTOR (0 = MOTOR 
OFF, 1 = MOTOR ON) 

* * * 

Programming £ h6_B B lZZ 3- 
Tvpe I Commands 
REST O R E (SE EK TRA.CK. -0 X _ 

Positions the read/write head to track zero. 

SETUP: None. 

RESULTS: Sets seek error status bit (if the V flag 
is set). 
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U 

U 

O 

u 

u 

u 

o 

o 

o 

o 

o 

O 
V .J 

o 
o 
<J 
^J 

o 

o 

o 

o 

o 

O 

o 

o 

o 

u 

o 

o 

o 

o 

o 

u 

o 

o 

o 

o 

u 

o 

o 

o 



SEEK 


n 

n 

n 

r ^ 
n 
n 

o 

n 

n 

n 

o 

r^ 

r^ 

r\ 

n 

n 

n 

o 

n 

r^ 

O 

o 

n 

o 

n 

n 

r*\ 

n 

o 

n 

n 


Finds a specified track by stepping the head to 
the track being sought. 

SETUP: Track register must contain the current 

track position of the R/W head and the data 
register contains the destination track 
position. 

RESULT: Moves the read/write head in the appropriate 
direction until both registers are equal 
(desired track location reached) and an 
interrupt is generated. 


.SHEER 


Steps the read/write head in the same direction 
as the last step operation. 

SETUP: None. 

RESULT: If the U flag is on, the track register is 
updated. Upon completion of the command an 
interrupt is generated. 

_ S TE g rJJi- 

Steps the read/write head in the direction 
towards track 79. 

SETUP: None. 

RESULT: If the U flag is on, the track register 
is incremented. Upon completion of the 
command an interrupt is generated. 


S . TE E-QUX- 

Steps the read/write head in the direction 
towards track zero. 

SETUP: None. 

RESULT: If the U flag is on, the track register 
is decremented. Upon completion of the 
command an interrupt is generated., 

* * * 
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Tvpell^Cojiunands 
READ SECTOR 


Reads a disk sector or sectors. 

SETUP: Place the desired track and sector number in 
the track and sector registers. 

RESULT: The disk drive attempts to read the 

selected sector or sectors from the disk. If 
the requested sector does not exist then the 
record not found status bit is set. Reading 
multiple sectors will be completed when 
the disk reaches the end of the current 
track or until the force interrupt command 
is loaded into the command register. 

_SffiI T . E _ S _ E .gE QR 

Write a disk sector or sectors. 

SETUP: Place the desired track and sector number in 
the track and sector registers. 

RESULT: The disk drive attempts to write the selected 
sector or sectors to the disk. If data is 
not ready or available then the load data 
status bit is set. 


U 

U 

u 

u 

u 

VJ 

u 

u 

u 

u 

o 

u 

u 

u 

u 

o 

o 


* * * 


JaOBfiL JU UL COfflffiandS 

Reads the next id field that is encountered and 
transfers the data to the data register. The id 
field consists of: track number, side number, 
sector number, sector length, crc one and crc 
two. Sector sizes are coded as follows: 

0 = 128 bytes 

1 = 256 bytes 

2 = 512 bytes 

3 = 1024 bytes 


SETUP: None. 

RESULTS: At the end of the commands operation an 

interrupt is generated and the busy status 
bit is reset. 
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U 
U 
^J 

u 

u 

u 

KJ 

KJ 

u 

u 

o 

u 

u 

u 

u 

O' 

u 





REAP TRACK 


n 

n 

r\ 

o 

n 

r*\ 

n 

n 

n 

n 

o 

r^ 

n 

r*\ 

r^ 

n 

r> 

r^ 

r^ 


r> 

n 

n 

n 

o> 

r^ 

r^ 

r^ 


Reads a track from the leading edge of the first 
index pulse and continues until the next index 
pulse. This command sends all gap, header and 
data bytes to the data register. The 
accumulation of bytes is synchronized to each 
address mark found. 

According to the WD177X specifications this 
command can be useful for diagnostic purposes. 

Since, no CRC checking is done, gap information is 
included in the data, and the address mark detector 
is on while the command executes. The specs also 
mention that write splices or noise may cause the 
WD177X to look for an address mark. 


NOTE: The ID address mark, ID field, ID CRC bytes, 

data address mark, data and data CRC bytes for 
each sector will be correct. Gap bytes may be 
read incorrectly during write splice time 
because of synchronization. 

SETUP: Position the read/write head over the 
desired track (the one to read). Then 
issue the read track command. 

RESULTS: An interrupt is generated upon command 
completion. 

mi TB . TOA gK- 

Format diskettes on a per track basis. 

SETUP: Position the read/write head over the 

desired track (the one to format). Then 
issue the write track command. 

RESULTS: Writing starts at the leading edge of 

the first index pulse encountered and 
continues until the next index pulse. An 
interrupt is then generated. If data is not 
loaded into the data register in time the 
WD177X may set the lost data status bit and 
then generate an interrupt. 

Sometimes the WD177X will use zeros as a 
substitute is data is not present in the 
data register. Disks may be formatted in 
IBM 3740 or System 34 formats with sector 
lengths of 128, 256, 512, and 1024 bytes. 
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The following chart lists special bytes 
used by the formatting process. 

BYTE IM DATA REGISTER MFM MBANHIS— 


00 

to 

F4 

Write 

0 to F4 in 

MFM 


F5 


Write 

Al* 

in 

MFM 

and 




present 

CRC 



F6 


Write 

C2* 

in 

MFM 



F7 


Generate 

two 

CRC 

bytes 

F8 

to 

FB 

Write 

F8 

to 

FB in MFM 


FC 


Write 

FC 

in 

MFM 



FD 


Write 

FD 

in 

MFM 



FE 


Write 

FE 

in 

MFM 



FF 


Write 

FF 

in 

MFM 



* * * 


Type IV 

FORCE INTERRUPT 

Used to stop the current command being executed 
by the WD177X (read and write commands) and it 
can be used to insure type I status in the 
status register. 

SETUP: None. 

RESULTS: Terminates the current command and resets 
the busy status bit. 

* * * 


WP 3.7-2X_N P tes_ 

The WD177X controller used in the 1581 is the 
WD1772 floppy disk controller chip. This chip must be 
accessed by machine language programs within the disk 
drive's memory. 

If you are planning to program the WD1772 then I 
highly recommend the information that is available 
from Western Digital. They have published a small 
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U 
U 
O 
O 
O 
V .J 
O 
^J 
O 

o 

o 

o 

o 

o 

o 

o 

u 

o 

o 

^J 
V .J 

o 

o 

O' 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 



r 

r 

r 

r 

r 

r 

r 

r 

r 

ns 

n\ 

ns 

ns 

ns 

rs 

rs 

r 

r 

r 

rs 

r 

r 

r 

r\ 

r 

ns 

r 

r 

r 

r 

r 

r 

r 

r 

r 

r 

r 

r 

r 


booklet that gives details about the WD1772 covering 
hardware and programming. 

See chapter 9 for information on how you can get 
the WD1772 booklet from Western Digital. 

NOTE: Some early 1581's contained the WD1770 
controller. If you have one of these drives it is 
recommended that you replace the WD1770 with a 
WD1772. Chapter 9 documents some known hardware bugs 
in the 1581 and Appendix A tells you about a program 
that will check for them. 
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XQ C AT ION 


IABEL 


DESCRIPTION 


$8000-$8001 

$8002-$8003 

$8004- 

$804C- 

$8050- 

$805B- 

$8067- 

$8071- 

$8085- 

$8099- 

$80A2- 

$811C- 

$8165- 

$81AF- 

$81E5- 

$81F1— 

° Copyright 
The 1581 DOS 


CHECKSUM 


EXECMD 

ENDCMD 

ENDO 

END1 

END2 

CLRCMD 

SCAN 

SCANCOLON 

TEST2FILES 

SCANCHARINA 

LOOKCMD 

CLRCMDVAR 

FLASHOFF 

FLASHON 


CHECKSUM USED BY 
ROUTINES TO VERIFY THE 
INTEGRITY OF THE DOS 
ROMS 

NOT USED BY THE DOS 

EXECUTE COMMAND STRING 

END OF COMPUTER COMMAND 
GENERATE AN ERROR 
MESSAGE 

END COMMAND BUT DON'T 
WRITE BAM 


END COMMAND 
ERROR 


IGNORE 


END COMMAND NO ERROR 
MESSAGE PREPARED 

CLEAR COMMAND BUFFER 

LOOK FOR AND DRIVE 

NUMBER IN COMMAND 
STRING 


LOOK FOR COLON 
COMMAND STRING 


IN 


TEST COMMAND WITH TWO 
FILENAMES FOR SYNTAX 

SEARCH INPUT LINE FOR 
CHARACTER IN THE 
ACCUMULATOR 

SET ALL FLAGS AND LOOK 
AT COMMAND STRING 
TABLE 

CLEAR AND SET BACK 
TABLE, POINTERS AND 
FLAGS 

FLASH ERROR LED OFF 

FLASH ERROR LED ON 
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o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 

o 


o 

o 

o 



n 




o 




n 

LOCATION 

LABEL 

DESCRIPTION 

n 




n 

$81FD- 

GETDRV 

GET DRIVE NUMBER AND 

n 



SET INTO FILE TABLE 

n 

$8224- 

G ETDRV FROMCMD 

GET DRIVE NUMBER FROM 




COMMAND STRING 


$8251- 

INITWITHLEDON 

INITIALIZE DRIVE AND 




SWITCH LED ON 


$8270- 

SETFILE 

SET AND DETERMINE FILE 

n 



TYPE 

o 

$8295- 

CHKDRV 

TEST VALID DRIVE NUMBER 

n 




n 

$82A2- 

INTDRVFNAME 

INITIALIZE DRIVE GIVEN 




IN FILENAME 


$82B9- 

FINDFILE 

LOOK FOR FILE ENTRY IN 

n 



THE DIRECTORY 


$8327- 

SCANDIR 

SEARCH DIRECTORY ENTRY 


$8336- 

SCANNEXT 

SEARCH NEXT ENTRY 

n 





$83D7- 

NEWSEARCH 

REINITIALIZE FILE 

o 



SEARCH FLAGS 

o 

$83E2- 

QUITSEARCH 

QUIT SEARCH FOR 




FILENAME 


$83FA- 

WCARD 

1581 EXTENDED WILD CARD 




CHECK 

n 

$8424- 

SETSEARCH 

SET INDICATOR TO SEARCH 

n 



IN DIRECTORY 

r^ 

$84AE- 

INTDSK 

INITIALIZE DISKETTE 

o 




***\ 

$84EE- 

WRTNAME 

COPY FILENAME FROM 

!\ 



INPUT BUFFER TO 

n 



DIRECTORY BUFFER 


$8508- 

COPYDATA 

COPY PART OF THE INPUT 

n 



BUFFER AND THE CURRENT 

n 



DATA BUFFER 

n 




r\ 




n 




n 
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U 




U 

I£>CATIQN 

LABEL 

DESCRIPTION 

u 

u 



$8526- 

FNAMELEN 

SEARCH LENGTH OF 

u 



FILENAME IN INPUT 



BUFFER (STARTING 




POSITION IN .X) 

u 

$854D- 

READFROMDIR 

READ FILE FROM 

o 



DIRECTORY 


$855D- 

DIROUTPUT 

ESTABLISH DIRECTORY FOR 

< J 



OUTPUT TO BUFFER 


$8610 

DELBUF 

DELETE BUFFER FOR DATA 

u 



NAME WITH EMPTY 

CHARACTER 

u 

$868B- 

BLKFRE 

SETUP CLOSING LINE OF 

o 



DIRECTORY WITH "BLOCKS 




FREE." MESSAGE 

J 

$867C-$8687 

BLKFREMSG 

"BLOCKS FREE." MESSAGE 


$8688- 

SCRATCH 

SCRATCH COMMAND - "S" 

o 





$86DB- 

FRESIDE 

FREE SIDE SECTOR BLOCKS 

O' 



IN A REL FILE 




u 

$8713- 

FREEUP 

PURSUE SECTORS ON HAND 




AND FREE UP IN BAM 





$8732- 

FREEUP1 

FREE SECTOR IN BAM AND 

u 



CONTINUE 




u 

$873B- 

DELFILE 

FILE ENTRY IN FILE TYPE 

u 



OF DIRECTORY MARKED AS 



SCRATCHED 

o 

$8746- 

NEW 

ROUTINE FOR 1581 "NEW" 




COMMAND (FORMAT DISK) 

u 



- "N" 

u 

$876E- 

COPY 

COPY COMMAND FOR 

u 



COPYING FILES - "C" 




u 

$879B- 

COPYFILE 

COPY FILES 

o 

$87F4- 

COPYSING 

COPY SINGLE FILES 


$8800- 

COPYMULT 

COPY MULTIPLE FILES 





< J 




u 




u 
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^J 




L J 



n 




o 





LOCATION 

LABEL 

DESCRIPTION 

n 




r\ 

$8841- 

OPENREAD 

OPEN CHANNEL TO READ 

n 



FILE 


$8876- 

GETBYTE 

READ A BYTE FROM A FILE 

n 

$8895- 

COPYREL 

COPY A RELATIVE FILE 





o 

$88C5— 

RENAME 

RENAME A FILE COMMAND¬ 
ER" 

o 




n 

$8903- 

CHKEXIST 

SEE IF FILE ENTRY 



EXISTS 

n 

$891E- 

CMPNAMES 

COMPARE WITH TWO 




FILENAMES 

n 





$892F- 

MEMCMD 

MEMORY COMMAND ROUTINES 


$8954- 

MEMREAD 

MEMORY READ COMMAND GET 




A BYTE FROM DRIVE 




MEMORY - "M-R" 


$8983- 

MEMWRT 

MEMORY WRITE COMMAND 




WRITE A BYTE INTO 

n 



DRIVE MEMORY - "M-W" 


$898F- 

USER 

USER COMMANDS TO START 

r^ 



PROGRAMS IN DOS BUFFER 
AT $0500 

n 




r^ 

$8996- 

BURSTCMD 

ROUTINE FOR BURST USER 



COMMANDS ("U0") 






$89CC- 

EXECUSER 

EXECUTE A USER COMMAND 

n 

$89E4- 

DIRECT 

COMMAND - OPEN A 




DIRECT CHANNEL 

r^ 

$8A5D- 

BLKCMDS 

BLOCK COMMANDS 

n 

$8A9F- 

BLKPARAM 

GET AND SET BLOCK 

n 



COMMAND PARAMETERS 

.0 

$8AAC- 

TESTPARAM 

TEST BLOCK COMMAND 

n 



PARAMETERS 

n 

$8AD0- 

ASCII2BIN 

CONVERT/SET BLOCK 




COMMAND PARAMETERS 
FROM ASCII TO BINARY 

0 




n 
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LOCATION 

LABEL 

DESCRIPTION 

$8B20- 

BINVAL 

BINARY VALUE TABLE $01, 
$0A, $64 

$8B23- 

BLKFRE 

BLOCK FREE COMMAND- 
FREE A BLOCK IN THE 
BAM - "B-F" 

$8B2F- 

BLKALLOC 

BLOCK ALLOCATE COMMAND 
- MARK A BLOCK IN THE 
BAM AS USED - "B-A" 

$8B65- 

TESTBR 

TEST BLOCK READ ("B-R") 
PARAMETERS AND READ 
SECTOR INTO BUFFER 

$8B6B- 

GETBUFBYTE 

GET BYTE FROM BUFFER 

$8B71- 

READSECINTPTR 

READ SECTOR FROM 

DISKETTE TO BUFFER AND 
INITIALIZE POINTER 

$8B85- 

BLKREAD 

READ SECTOR FROM 

DISKETTE FOR "B-R" 
COMMAND 

$8B8E- 

BREXTEND 

BLOCK SHIFT READ 

COMMAND - EXTENDED 
TRACK READER 

$8B9A- 

USER1CMD 

ROUTINE FOR "Ul" 

COMMAND READ SECTOR 
FROM DISKETTE 

$8BAE- 

BLKWRT 

ROUTINE FOR BLOCK WRITE 
COMMAND "B-W" 

$8BD1- 

BWEXTEND 

BLOCK SHIFT WRITE 
COMMAND - EXTENDED 
TRACK WRITER 

$8BD7- 

USER2CMD 

ROUTINE FOR "U2" 

COMMAND WRITE SECTOR 
TO DISKETTE 

$8BE3- 

BLKEXEC 

ROUTINE FOR BLOCK 
EXECUTE COMMAND READ 
SECTOR AND EXECUTE 
CODE IN DOS BUFFER 
"B-E" 
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u 

u 

u 

o 

u 

u 

u 

{J 

<J 

u 

u 

u 

u 

u 

u 

o 




n 








n 

LOCATION 

LABEL_ 

DESCRIPTION 






$8BFA- 

BLKPTR 

ROUTINE FOR BLOCK 




POINTER COMMAND SET 
BUFFER POINTER ("B-P") 





$8C0F- 

ALLOCOPEN 

ALLOCATE BUFFER AND 




OPEN CHANNEL 

r > 





$8C2F- 

CHKPARAM 

TEST PARAMETERS FOR 




VALID SECTOR 




ASSIGNMENT 


$8C44- 

SKIPILLEGAL 

SAME AS ABOVE, BUT DOES 




NOT FLAG ILLEGAL 

n 



TRACKS AND/OR SECTORS 


$8C5C- 

ALLOCBUF 

ALLOCATE RAM BUFFER- 




.A CONTAINS THE BUFFER 




NUMBER (1 = BUFFER 0, 




2 * BUFFER 2, ETC.) 

rN 

$8C61-$8C6A 

BLKCMDTAB 

BLOCK COMMAND TABLE 




"AFRWEPRW?*" 

r^ 

$8C6B-$8C7E 

BLKADDR 

ADDRESSES OF 10 BLOCK 

n 



COMMANDS IN LOW, HIGH 
BYTE FORMAT 

o 




r*\ 



$8B2F - "B-A" 

$8B2 3 - "B-F" 

r*s 

n 



$8B85 - "B-R" 

$8BAE - "B-W" 

$8BE3 - "B-E" 




$8BFA - "B-P" 

/-“*K 



$8B8E - "B-R" 

' \ 



$8BD1 - "B-W" 

n 



$8C7F - "B-?" 




$8C84 - "B-*" 


$8C7F- 

AUTHOR 

BLOCK-? COMMAND 




AUTHOR/DESIGNER 




MESSAGE IN ERROR 




CHANNEL - "B-? M 

n 

$8C84- 

DEDICATE 

BLOCK-* COMMAND 

n 



DEDICATION MESSAGE IN 
ERROR CHANNEL - "B-*" 

n 




o 

$8C89- 

GETREC 

GET RECORD FROM 



RELATIVE FILE 

r*> 




r*\ 
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U 




U 
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LABEL 
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u 




u 

$8CC1- 

NUMBYTES 

COMPUTE NUMBER OF BYTES 

o 



UP TO RECORD 

u 

$8D06- 

DIV254 

DIVISION OF MATH 

o 



REGISTER BY 254 

(SECTOR LENGTH) 

o 




u 

$8D09- 

DIV120 

DIVISION OF MATH 

o 



REGISTER BY 120 



(RECORD ENTRIES IN 

u 



SIDE-SECTOR) 

u 

$8D38- 

CLRMATH1 

CLEAR MATH REGISTER 1 

u 

$8D41- 

MULTTIMES4 

MULTIPLY MATH REGISTER 

u 



2 FOUR TIMES 

o 

$8D44- 

DOUBLEREG2 

DOUBLE MATH REGISTER 2 

u 

$8D4C- 

ADD1T02 

ADD MATH REGISTER 2 TO 

o 



MATH REGISTER 1 

o 

$8D59- 

INTBUFCHAN 

INITIALIZE BUFFER 

o 



CHANNEL TABLE 

o 

$8D68- 

TESTCHANNUM 

TEST CHANNEL NUMBER IN 

u 



BUFFER CHANNEL TABLE 

u 

$8D7D- 

MAMBUF 

MANAGE AND ASSIGN 

u 



BUFFERS 

o 

$8E3C- 

FINDFREBUF 

LOOK FOR A FREE BUFFER 

u 




v .J 

$8E4D- 

SETBUFSTATUS 

TOGGLE BUFFER FROM 

<J 



ACTIVE TO PASSIVE AND 



BACK AGAIN 

o 

$8E5C- 

WRTINTERNAL 

WRITE BYTES OVER 

o 



INTERNAL CHANNEL INTO 

Vj 



BUFFER 

u 

$8E78- 

WRT2FILE 

WRITE BYTE INTO FILE 

o 

$8EB1- 

WRT2BUF 

WRITE BYTE IN CURRENT 

o 



BUFFER 

o 

$8EC5- 

INITIALIZE 

INITIALIZE COMMAND- 

o 



"10" 

^J 




o 




u 
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o 




o 



o 









LOCATION 

LABEL_ 

DESCRIPTION 





n 

$8FD6- 

READ2BUF 

READ SECTOR FROM 

n 



DISKETTE TO BUFFER 

n 

$8FEA- 

READNEXT 

READ IN GIVEN SECTOR 

o 



AND SECTOR AFTER THAT 

n 

$8FFE- 

READSEC 

READ SECTOR FROM DISK 

n 

$9002- 

WRTSEC 

WRITE SECTOR TO DISK 





o 

$9027- 

OPENREAD 

OPEN CHANNEL FOR 



READING 






$9042- 

SCANANDOPEN 

SEARCH FOR AND OPEN 



CHANNEL 





n 

$905F- 

GETFILETYPE 

GET CURRENT FILE TYPE 


$9069- 

GETCHANANDBUFF 

GET CHANNEL AND 

/*s 



MATCHING BUFFER NUMBER 


$9071- 

GETFROMBUF 

GET BYTE FROM CURRENT 

n 



BUFFER 

n 

$909B- 

GETFROMFILE 

GET BYTE FROM FILE 


$9112- 

WRT2FILE 

WRITE BYTE IN FILE 


$9138- 



r^ 

NEXTCHAR 

SET CURRENT BUFFER 



POINTER TO NEXT 

n 



CHARACTER 

n 

$9145- 

SWITCHAUTO 

SWITCH FOR AUTOLOADER 




BOOT ON INITIALIZE OR 
BURST INQUIRY/QUERY 

n 




r^ 

$9157- 

SCANWRTCHAN 

LOOK FOR WRITE CHANNEL 



AND BUFFER 

n 




n 

$915A- 

SCANREADCHAN 

LOOK FOR READ CHANNEL 



AND BUFFER 

r^ 




n 

$919E- 

FRECHAN 

FREE UP CHANNEL 

r^ 

$91CE- 

FREBUFCHAN 

FREE UP BUFFER AND 




CORRESPONDING CHANNEL 

n 





$9204- 

SCAN4BUF 

LOOK FOR BUFFER 


$9228- 

SCAN4FREBUF 

LOOK FOR FREE BUFFER 

o 




o 
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U 




U 

LOCATION 

LABEL 

DESCRIPTION 

u 




kj 

$923E- 

FREINACT 

FREE UP ALL INACTIVE 

kj 



BUFFERS 

o 

$9252- 

FREEINDEX 

FREE UP BUFFER INDEX 


$9262- 

CLOSECHAN 

CLOSE CHANNELS 0 TO 14 

u 




u 

$926E- 

FREEALLCHAN 

FREE UP ALL CHANNELS ON 



CURRENT DRIVE 




u 

$9291- 

GETBUFF 

GET A BUFFER 

u 

$92DB- 

LAYOUTFREE 

SEEK AND LAYOUT A FREE 

u 



CHANNEL 




u 

$92F4- 

GETFROMCHAN 

GET A BYTE FROM A 

u 



CHANNEL 




u 

$9303- 

READFROMFILE 

READ BYTE FROM A FILE 


$933A- 

READFROMREL 

GET BYTE FROM A 



RELATIVE FILE 

u 

$9348- 

GETNEXT 

GET NEXT BYTE FROM FILE 

o 

$934A- 

GETCURREN 

GET CURRENT BYTE FROM 

u 



FILE 

kj 

$9370- 

READERRCHAN 

READ ERROR CHANNEL 

u 




u 

$9396- 

ERRPTR 

SET POINTER FOR ERROR 

u 


MESSAGE POINTER 





$939F- 

INITERRCHAN 

INITIALIZE ERROR 

kj 



MESSAGE CHANNEL 




u 

$9 3AA- 

READNXTSEC 

READ NEXT SECTOR OF A 

k J 



FILE 

kj 

$93B0- 

JOBREAD 

TAKE JOB CODE FOR READ 



SECTOR ($80) 

kJ 

$93C1- 

JOBWRT 

TAKE JOB CODE FOR WRITE 




SECTOR ($90) 

kj 

$93CF- 

OPENSEQREAD 

OPEN SEQUENTIAL FILE 

kj 



FOR READING 

k^ 

$93E0- 

OPENSEQWRITE 

OPEN FILE FOR WRITING 





k J 




kj 
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kj 



n 




r*\ 




r ^ 

LOCATION 

LABEL 

DESCRIPTION 






$93E7- 

WRTNEXTDIR 

WRITE NEXT DIRECTORY 

n 



SECTOR 


$9422- 

SETBUFPTR1 

SET BUFFER POINTER TO 




GIVEN POSITION 

r ^ 

$9434- 

CLOSEINTERNAL 

CLOSE INTERNAL CHANNELS 


$9442- 

CURRENTBUF 

DETERMINE CURRENT 




BUFFER POINTER 


$9445- 

SETBUFPTR2 

SET BUFFER POINTER 




(BUFFER NUMBER IN .A) 

n 





$9450- 

GETBUFBYTE 

READ ANY BYTE FROM 



BUFFER (.A MUST 




CONTAIN POSITION OF 
THE CHARACTER) 





$9460- 

CHKTRKSEC 

TEST FOR VALID TRACK 




AND SECTOR NUMBERS 




THEN SET JOB CODE 

n 

$94A8- 

GETTRKSEC 

GET TRACK AND SECTOR OF 




CURRENT JOB FROM JOB 

o 



MEMORY 

O 

$94B5- 

RANGECHK 

CHECK CURRENT TRACK AND 

/^V 



SECTOR FOR ALLOWABLE 

t > 



RANGE 

n 





$94CB- 

FALSEFORMAT 

DISPLAY ERROR MESSAGE 

1} 



FOR FALSE FORMAT 

o 




n 

$94D3- 

SENDJOBCURBUF 

SEND JOB FOR CURRENT 



BUFFER TO JOB LOOP 


$94DE- 

READNWAIT 

SEND JOB CODE FOR READ 

r\ 



TO JOB LOOP AND WAIT 

r *\ 



UNTIL EXECUTION 

n 

$94E2- 

WRTNWAIT 

SAME AS ABOVE EXCEPT 

n 



WRITE 


$94E4- 

EXECJOB 

EXECUTE JOB FOR CURRENT 

o 



DRIVE (JOB CODE IN .A) 


$94E6- 

EXECJOB2 

EXECUTE JOB CODE (JOB 




CODE IN .A, BUFFER 
NUMBER IN .X) 
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LOCATION 


LABEL 


DESCRIPTION 


$94E8- 

EXECJOB3 

EXECUTE JOB 

$94ED- 

JOBDONE 

WAIT UNTIL JOB IS 
EXECUTED AND AN ERROR 
MESSAGE IS PREPARED 

$94F8- 

SUPERVISE 

SUPERVISE THE CURRENT 
JOB RUN 

$951A- 

NXTRKONERR 

SET HEAD TO NEXT TRACK 
AFTER A READ ERROR- 
SEARCH SOME MORE 

$9564- 

WAITTILDONE 

JOBCODE EXECUTES UNTIL 
SUCCESSFUL OR UNTIL 
COUNTER IN $30 = 0 

$9585- 

SENDCURRENT 

SEND CURRENT TRACK AND 
SECTOR NUMBERS TO JOB 
LOOP 

$9588- 

SENDTRKSEC 

SEND TRACK AND SECTOR 
NUMBERS TO JOB LOOP 
(BUFFER IN .A) 

$959D- 

DIRECTCALL 

DIRECT 1581 CONTROLLER 
CALL 

$95AB- 

CLOSEFILE 

CLOSE A FILE ENTRY IN 
THE DIRECTORY 

$9678- 

OPENCMD 

TAKE ON OPEN COMMAND 
WITH A SECONDARY 
ADDRESS 0 TO 14 

$97A2- 

SAVEREPLACE 

OVER WRITE 

CORRESPONDING FILE 
ENTRY 

$984D- 

OPENREADFILE 

OPEN A FILE FOR READING 

$9890- 

OPENWRTFILE 

OPEN A FILE FOR WRITING 

$98AB- 

SETCMD 

SETUP FILE TYPE AND 
FILE OPERATION AS 
COMMAND STRING 

$98CC- 

APPEND2FILE 

PREPARE FILE FOR APPEND 
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VJ 

u 

u 

u 

u 

u 

u 

u 

u 

u 

u 

u 

u 

u 

u 

u 

<sj 

u 

u 

u 

u 

o 

u 

u 

u 

o 

u 

u 

w 

VJ 

u 



n 

n 

n 

ns 

n 

n 

n> 

n 

n 

n 

n 

n 

ns 

n 

n 

n 

ns 

n 

n 

ns 

ns 

n 

ns 

ns 

n 

n 

n 

n 

n 

r\ 

n 

ns 

n 

n 

ns 

n 

n 

n 

ns 

ns 

n 

n 



$98F7- 

XMITDIR 

TRANSMIT DIRECTORY TO 
COMPUTER 

$9950- 

CLOSEAFILE 

CLOSE A FILE 

$9986- 

CLOSEALL 

CLOSE ALL FILES 

$999F- 

CL0SE2ND 

FILES DECLARED THROUGH 
SECONDARY ADDRESS 
CLOSED 

$9A2A- 

WRTLASTSEC 

WRITE THE LAST SECTOR 
OF A FILE TO DISKETTE 

$9A72- 

CLOSEWRT 

CLOSE DIRECTORY ENTRY 
AFTER WRITE OPERATION 

$9B0D- 

OPENREADCHAN 

OPEN CHANNEL TO READ 
FILE 

$9B9B- 

INITOPENPTR 

INITIALIZE CHANNEL OPEN 
POINTER 

$9BC3- 

OPENWRTCHAN 

OPEN CHANNEL TO WRITE 
TO A FILE 

$9082- 

SETRELSS 

SETUP A REL FILE SIDE 
SECTOR 

$9CCA- 

WRT2SS 

WRITE A BYTE TO CURRENT 
SIDE SECTOR 

$9CD3- 

CHANINFT 

CHANNEL NUMBER IN FILE 
TYPE FLAG SET (CARRY = 
1) OR CLEARED (CARRY = 
0) 

$9CD5- 

CHFT1 

VALUE COMBINED IN FILE 
TYPE (BIT = 1 IS SET) 

$9CDB- 

CHFT2 

REMOVE VALUE FROM THE 
FILE TYPE FLAG (BIT = 
1 IS TAKEN OUT/NOT 
SET) 

$9CE4- 

CHFT3 

CHECK FOR SET FILE TYPE 


FLAG (THE FLAG VALUE 
IS IN .A) 
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$9CE9- 


CHFT4 


CHECK TO SEE IF JOB 
CODE IS SETUP FOR 
WRITING 


$9CF5- 


TESTFPTR 


TEST FILE POINTER 


$9D2E- 

$9D3A- 


$9D49- 


$9D56- 


$9D69- 


$9D79- 


$9D7C- 


BUF2DSK 


SETCHAIN 


GETCHAIN 


SETENDLNK 


BUFPTRO 


GETCURTRKSEC 


GETCUR2 


WRITE BUFFER TO DISK 

SET CHAINED BYTES WHICH 
POINT TO THE NEXT 
SECTOR 

GET LINKED BYTES WHICH 
POINT TO THE NEXT 
SECTOR 

SET SECTOR LINK BYTES 
AS LAST SECTOR IN 
CHAIN OF LINKED BYTES 
AND/OR SECTORS 

SET CURRENT BUFFER 
POINTER TO ZERO 

GET CURRENT TRACK AND 
SECTOR OF CURRENT 
JOB/GET CHAN OF 
CURRENT SECONDARY 
ADDRESS 

GET TRACK AND SECTOR OF 
CURRENT JOB/DETERMINE 
BUFFER 


$9D8E- 


$9DCE- 


$9DDE- 


SENDJOB 


NXTLINK 


BUFCOPY 


GIVE JOB CODES TO JOB 
LOOP 

NEXT SECTORS PARAMETERS 
SET BY LINKED BYTES 
THAT ARE ON HAND 

COPY FILE FROM ONE 
BUFFER TO ANOTHER 
BUFFER. THE .A 
CONTAINS THE NUMBER OF 
BYTES TO TRANSFER, .YR 
IS THE SOURCE BUFFER 
NUMBER, AND .XR IS THE 
DESTINATION BUFFER 
NUMBER. 
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n 

n 

$9DFA- 

CLRBUFF 

CLEAR THE BUFFER NUMBER 
IN .A WITH ZEROS 

n 

ns 

$9E0B- 

SETSSNUM 

GET THE NUMBER OF THE 
CURRENT SIDE SECTOR 

n\ 

n 

$9E15- 

SETBUFPTR 

SET THE BUFFER POINTERS 
$ 6 4 / $ 6 5 TO ANY 

POSITION IN THE BUFFER 


$9E23- 

SETBUFPTR 

SET THE BUFFER POINTER 

ns 

n 

n 

$9E32- 

READSIDE 

READ A SIDE SECTOR INTO 
A BUFFER AND SETUP 
POINTERS 

n 

n 

n 

n 

$9E56- 

READSEC 

READ A SECTOR- THE 
BUFFER POINTER OF THE 
CURRENT BUFFER MUST 
USE THE TRACK AND 
SECTOR PARAMETERS OF 
THE LINK BYTES 

n 

n 

$9E75- 

SETSSPTR 

SET THE SIDE SECTOR 
POINTER 

n 

n 

n 

$9E7D- 

CALCNUMSS 

CALCULATE THE NUMBER OF 
SIDE SECTORS IN A 
RELATIVE FILE 

n 

ns 

$9EE4- 

SSSTATUS 

TEST STATUS OF A SIDE 
SECTOR 

n 

ns 

$9F11- 

CURBUF 

DETERMINE NUMBER OF THE 
CURRENT BUFFER 

n 

ns 

$9F1C- 

CURBUFST 

GET CURRENT BUFFER 
STATUS 

n 

n 

$9F33- 

BUFFREORNOT 

TEST WHETHER BUFFER IS 
FREE 

n 

ns 

$9F3E- 

TWOBUFF 

ACTIVATE BUFFERS FOR 
TWO BUFFER OPERATIONS 

n 

n 

$9F4C- 

WRTREC 

WRITE A RECORD FOR A 
RELATIVE FILE 

n 

$9FB6- 

PTR2LAST 

SET POINTER TO LAST 
CHARACTER 
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U 




U 

^LOCATION 


DESCRIPTION 

u 




$9FBF- 

PREPRECSEC 

PREPARE SECTOR OF THE 

u 



RECORD 

u 

$9FFC- 

WRTRECCHAR 

WRITE A CHARACTER OF 

\J 



THE RECORD INTO THE 
BUFFER 





^J 

$A033- 

WRTREC 2 DATABUF 

WRITE RECORD TO THE 

o 



DATA BUFFER 




u 

$A07B- 

FILREC 

FILL THE REST OF A 




RECORD WITH EMPTY 



BYTES ($00/0) 

O 

$A08D- 

DATAALT 

FLAG FOR BUFFER DATA 




ALTERED IS SET 


$A09C- 

DATANOTALT 

FLAG FOR BUFFER DATA 

u 



ALTERED IS CLEARED 


$A0A6- 

GETFROMREC 

GET A BYTE FROM A 

KJ 



RECORD 

U 

$A0E1- 

OUTPUTAREC 

GET A RECORD AND OUTPUT 

u 



IT 

u 

$AOEC- 

RECNOTHERE 

RECORD NOT PRESENT 

u 



ERROR 

u 

$AOFD- 

LSTRECCHAR 

SET POINTER TO LAST 

u 



CHARACTER OF THE 
RECORD 

o 




o 

$A143- 

FINDENDREC 

SEARCH FOR THE END OF A 




RECORD 





$A15C- 

FINDENDREL 

SEARCH FOR THE END OF A 




RELATIVE FILE 

$A1A1- 



u 

RECORD 

RECORD COMMAND ROUTINE 

^J 



(itpti) 

$A20D- 



w 

READREC 

READ A RECORD INTO THE 

o 



BUFFER 

$A235- 




READRECSEC 

READ THE RECORD SECTOR 

u 



CONTAINED IN THE 



BUFFER 

o 
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u 








n 





n 





r> 

LOCATION 

LABEL 


DESCRIPTION 

ns 





n 

$A273- 

CHKSEC 

CHECK TO 

SEE IF SECTOR 

n 



IS ALREADY IN THE 

ns 



BUFFER 


ns 

$A298- 

ADDREC 

ENTER A 

NEW RECORD IN 

n 



THE SECTOR 

n 

$A2BC- 

CALCRECPOS 

CALCULATE 

POSITION OF A 

n 



NEW RECORD IN THE 



SECTOR 







o 

$A2D6- 

INSERTNEWREC 

INSERT A 

NEW RECORD IN 



A RELATIVE FILE 







$A459- 

NEWSS 

PREPARE 

A NEW SIDE 



SECTOR 







ns 

$A547- 

SUPERSS 

ROUTINES 

FOR HANDLING 



SUPER SIDE SECTORS 

ns 

$A602-$A730 ERRMSGS 

ERROR MESSAGES STORED 

<n 



AS ASCII 

TEXT 

n 


ERROR NUMBER 


TEXT 

n 





n 

$A602- E00 

00 

"OK" 

n 

$A606- E02 

02 

"PARTITION 

n 




SELECTED" 

ns 

$A61A- E20ETC 20 

-24,27 

"READ ERROR" 

n 

$A625- E52 

52 

"FILE TOO 

n 




LARGE" 

n 

$A631- E50 

50 

"RECORD NOT 

o 




PRESENT" 

n 

SA63C- E51 

51 

"OVERFLOW IN 

n 




RECORD" 

n 

$A649- E25 

25 

"WRITE ERROR" 

n 

$A64D- E26 

26 

"WRITE 

n 




PROTECT ON" 

ns 

$A65A- E29 

29 

"DISK ID 

n 




MISMATCH" 

n 





n 





n 
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ns 







u 

u 


LOCATION 

LABEL 


DESCRIPTION 

u 





u 


ERROR NUMBER 


TEXT 

u 





o 

$A660- 

E30ETC 

30-34 

"SYNTAX 

o 




ERROR" 

$A66C- 

E60 

60 

"WRITE FILE 





OPEN" 

o 

$A670- 

E63 

63 

"FILE EXISTS" 

o 





o 

$A679- 

E64 

64 

"FILE TYPE 





MISMATCH" 





o 

$A681- 

E65 

65 

"NO BLOCK" 

VJ 

$A68A- 

E66ETC 

66-67 

"ILLEGAL 

u 




TRACK OR 

SECTOR" 

o 





o 

$A6A3- 

E61 

61 

"FILE NOT 

o 




OPEN" 





u 

$A6A7- 

E39/62 

39,62 

"FILE NOT 

u 




FOUND" 





o 

$A6AC- 

E01 

01 

"FILES 

<J 




SCRATCHED" 

$A6B9- 

E70 

70 

"NO CHANNEL" 

o 




u 

$A6C4- 

E71 

71 

"DIRECTORY 

u 




ERROR" 





o 

$A6C9- 

E72 

72 

"DISK FULL" 

o 

$A6D0- 

E73 

73 

"COPYRIGHT 

o 




CBM DOS VI0 
1581" 

o 





o 

$A6EB- 

E74 

74 

"DRIVE NOT 

u 




READY" 





o 

$A6F8- 

E75 

75 

"FORMAT 

u 




ERROR" 





u 

$A705- 

E76 

76 

"CONTROLLER 

o 




ERROR" 


o 


v j 

u 
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o 



r\ 

r^ 
r ^ 

n 

n 

r*\ 

o 

rv 

rs 

r^s 

n 

n 

n 

n 

o 

n 

r\ 

r*\ 

r*s 

O 

n 

rs 

o 

rN 

r*s 
r ^ 

o 



$A716- 

E77 

77 

"SELECTED 

PARTITION 

ILLEGAL" 

$A731- 

E79 

79 

"SOFTWARE BY 
DAVID 
SIRACUSA. 
HARDWARE BY 
GREG 
BERLIN" 


$A75F- 

E7A 


7A 

"DEDICATED 
TO MY WIFE 
LISA" 

$A779- 

$A7AD 

ERRTOK 

-TOKEN. 

ERROR MESSAGE TOKENS 

.NUMBER, TEXT 

$A779- 

T09 


09 

"ERROR" 

$A77F- 

TOA 


0A 

"WRITE" 

$A785- 

TO 3 


03 

"FILE" 

$A78A- 

T04 


04 

"OPEN" 

$A78F- 

T05 


05 

"MISMATCH" 

$A798- 

T06 


06 

"NOT" 

$A79C- 

T07 


07 • 

"FOUND" 

$A7A2- 

T08 


08 

"DISK" 

$A7A7- 

TOB 


0B 

"RECORD" 

$A7AE- 


DOERR 

ERROR MESSAGE OUTPUT 
ROUTINE .A MUST 

CONTAIN THE ERROR 
NUMBER, .XR THE BUFFER 
NUMBER 

$A7F1- 


PREPMSG 

PREPARE 

MESSAGE 

THE ERROR 

$A7F4- 


ACTMSG 

ACTIVATE 

ERROR MESSAGE 

$A83E- 


BIN2BCD 

CONVERT A 
TO A BCD 

BINARY NUMBER 
' NUMBER 

$A850- 


BCD2ASCII 

CONVERT 

INTO 

A BCD NUMBER 
TWO ASCII 


CHARACTERS 
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LABEL 


$A862- 


PREPARE "00, OK" ERROR 
MESSAGE 


$A867- 


ERRTRKSEC OUTPUT ERROR MESSAGE 

WITH TRACK AND SECTOR 
NUMBERS = 0 


$A86D- 


$A8AD- 


ERRBUF 


WRTMSG2BUF 


PRODUCE ERROR MESSAGE 
IN BUFFER (BUFFER 
NUMBER IN .A) 

WRITE ERROR MESSAGE IN 
TEXT FORM TO ERROR 
BUFFER 


$A8F8- 


WRTASCIIMSG 


WRITE ASCII CHARACTERS 
INTO A BUFFER. NON¬ 
ASCII CHARACTERS 
INTERPETED AS ERROR 
NUMBERS 


$A90E- 


ERRMSGFROMROM GET A CHARACTER OF 
ERROR TEXT FROM THE 
ERROR MESSAGE TEXT 
TABLE IN ROM 


$A91C- 


GETBYTETAB GET THE CURRENT BYTE 

FROM THE TABLE 


$A926-$A937 


AUTOFILENAME AUTO EXECUTE FILE NAME. 


FIRST CHARACTER IS THE 
COMMAND 

"SCOPYRIGHT CBM 86" 


$A938- 


AUTOLOADER 


CBM AUTO LOADER ROUTINE 


$A94C- 


DISABLEAUTO 


RETURN FROM THE AUTO 
LOADER WITH THE AUTO 
LOADER DISABLED 


SA956- 


UTILITYCMD UTILITY LOADER COMMAND 

FIND AND GET 
UTILITIY LOADER PROGRAM 
BLOCK 
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n 




n 




ns 

LOCATION 

LABEL 

DESCRIPTION 

n 




n 

$A9F5- 

GETUTL 

READ IN A BYTE FROM 

n 



UTILITY LOADER PROGRAM 
BLOCK 

rN 




ns 

$AA07- 

UTLCHKSUM 

IMPLEMENT A CHECKSUM 




FOR UTILITY LOADER 




PROGRAM BLOCK 

ns 

$AAOF- 

SETERRVEC 

SET ERROR VECTORS TO 

n 



ROUTINE AT $A94C 

ns 

$AA27- 

INTERLEAVE 

"UO>SX" COMMAND SET 

ns 



SECTOR FORMAT FOR CBM 

ns 



DISKETTES (INTERLEAVE) 

n 

$AA2D- 

READATTEMPT 

11 U 0 >RX" COMMAND SET 

n 



NUMBER OF READ 

ATTEMPTS 

n 





$AA33- 

SIEEETIMING 

" U 0 > I X " COMMAND 

/ A 



FUNCTION SET SIEEE 

fN 



TIMING 

ns 

$AA3 9- 

TESTROM 

"UO>T" COMMAND TEST ROM 

ns 



CHECKSUM AKA ROM 

ns 



SIGNATURE ANALYSIS 

r\ 

$AA3C- 

BURSTUTL 

DECODE AND EXECUTE 



DRIVE STATUS AND 
CONTROL FUNCTIONS 

n 

ns 

$AA65- 

SETDEVICE 

SET DEVICE NUMBER VIA 

n 



,, UO>"+CHR$ (X) 

r\ 

$AA83- 

SYNTAXERR 

SYNTAX ERROR MESSAGE 

n 




ns 

$AA88- 

BUSMODE 

"UO>BX" COMMAND SET 

ns 



SERIAL BUS MODE (SLOW 

n 



OR FAST) 

n 

$AA9A- 

VERIFYMODE 

,, UO>VX" COMMAND SETS 




VERIFY MODE SELECTION 

n 



(ON OR OFF) 

n 




r\ 

$AAA8- 

BURSTMEMCMDS 

BURST MEMORY READ AND 


WRITE COMMANDS 

n 

$AAC3- 

BURSTMEMREAD 

BURST MEMORY-READ 

ns 


COMMAND 

n 




n 
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LOCATION 

LABEL 

DESCRIPTION 

$AAD7- 

BURSTMEMWRT 

BURST MEMORY-WRITE 
COMMAND 

$AB09- 

SETVERIFY 

CHECK VERIFY MODE 
SELECT VALUE EITHER 
ZERO OR ONE 

$AB1D- 

SIGNATURERTN 

ROM SIGNATURE ANALYSIS 
ROUTINE TEST ROM VIA 
CHECKSUM 

$ABCF- 

ATN 

ROUTINE FOR CONTROLLING 
THE SERIAL BUS (SERIAL 
BUS ATN SERVER) 

$ACBB- 

BUS2INPUT 

SWITCH 1581 BUS TO 
INPUT 

$ACD4- 

BUS20UTPUT 

SWITCH 1581 BUS TO 
OUTPUT 

$ACE8- 

DATALOW 

DATA LINE SET LOW 

$ACF1- 

DATAHI 

DATA LINE SET HIGH 

$ACFA- 

CLOCKHI 

CLOCK LINE SET HIGH 

$AD03- 

CLOCKLOW 

CLOCK LINE SET LOW 

$ADOC- 

SERVAL 

VALUES READ FROM SERIAL 
BUS 

$AD2F- 

DELAY1 

CYCLE DELAY 

$AD34- 

DELAY2 

CYCLE DELAY 

$AD3C- 

UICMD 

"UI" COMMAND BUS MODE 
COMMAND 1541/1540 

SPEED 

$AD5C- 

TALK 

SERIAL BUS TALK ROUTINE 

$AEB8- 

LISTEN 

SERIAL BUS LISTEN 
ROUTINE 

$AED9- 

RESETBUS 

RESET BUS CONTROL 
REGISTER AND WAIT FOR 


NEXT COMMAND 


° Copyright 1988 D. W. Martin All Rights Reserved. 
The 1581 DOS Reference Guide -87- Chapter 8 



n 








n 




n 

r^ 

LOCATION 

LABEL 

DESCRIPTION 





$AEEA- 

SETSERIAL 

SPINP/SPOUT SETUP FAST 

f ! 



SERIAL DIRECTION AS 

n 



INPUT OR OUTPUT 




(CARRY SET = SPOUT, 




CARRY CLEAR = SPINP) 

n 

$AEF2- 




RAMORROMERR 

RAM OR ROM ERROR 

f i 



(TEST/CHECKSUM) 

n 

$AF24- 



n 

TESTRAM&ROM 

TEST THE 1581'S RAM AND 
ROM 


$AFCA- 




INITZPG 

INITIALIZE ZERO PAGE 

o 

$AFDE- 

PUPMSG 

GENERATE DOS POWER UP 




MESSAGE 


$B0B3- 

INITLAYOUT 

INITIALIZE DISK LAYOUT 

r\ 



VARIABLES (MAX TRACK, 
DIR TRACK, ETC.) 

o 

$BOCF- 

FORMATNORM 

SET UP A "NORMAL" DOS 




FORMAT FOR BURST 

o 



FORMAT COMMAND 

/~\ 

$BOFO- 

IDLE 

MAIN IDLE LOOP 

r\ 

$B17C- 

LOADDIR 

LOAD DIRECTORY "$" 

r^ 




r> 

$B201- 

DIREND 

DIRECTORY OUTPUT ENDED 

n 

SB237- 

COPYDIR 

COPY DIRECTORY ENTRY 

o 



INTO CURRENT BUFFER 

n 

$B245- 

GETDIRBYTE 

GET A BYTE FROM THE 

n 



DIRECTORY 

n 

$B262- 

VALIDATE 

VALIDATE COMMAND 

n 



ROUTINE 

r^ 

$B286- 

REPAIRBAM 

ALL BLOCKS OF A FILE 



PUT INTO BAM ALLOCATES 

/*\ 



BLOCKS ACCORDING TO 

n 



FILE LINK BYTES 

r\ 

$B2C7- 

TSTBLOCKS 

ALL BLOCKS FOLLOWING A 

n 



FILE ARE TESTED FOR 
VALIDITY 

n 








r*s 




r\ 
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LOCATION 

LABEL 

$B2EF- 

TSTILLEGAL 

$B348- 

NEW/FORMAT 

$B390- 

NEWBAM 

$B430- 

CLRBAMBUF 

$B44A- 

NEWBAM2 

$B546- 

FRESEC 

$B572- 

SECUSED 

$B5B4- 

DRVNOTREADY 

$B5D8- 

BAMPTR 

$B5EA- 

ISOLATEMASKS 

$B668- 

SCANFREBLK 

$B6BF- 

NXTFREONTRK 

$B6ED- 

NXTOPTSEC 

$B75E- 

NUMFREALL 

$B781- 

PARTITION 


DESCRIPTION 


CHECK FOR ILLEGAL 
SYSTEM TRACK OR 
SECTORS 

FORMAT COMMAND (NEW) 

CREATE A NEW BAM (ALL 
SECTORS FREE) 

CLEAR BAM BUFFERS 

PRODUCE A NEW 1581 BAM 
FOR VALIDATE COMMAND 

SECTOR RELEASED AND 
MARKED AS FREE 

MARK A SECTOR IN THE 
BAM AS USED. IF NONE 
ARE FREE THEN A "DISK 
FULL" ERROR IS 
PRODUCED. 

PRODUCES "DRIVE NOT 
READY” ERROR 

BAM BUFFER POINTER SET 
TO BIT FOR CURRENT 


SECTOR 

RETRIEVED 

AND 

BIT 

MASKS 

TO 

ISOLATE 

BAM 

BITS 




LOOK 

FOR 

NEXT 

FREE 

BLOCK 

IN THE BAM 


LOOK 

FOR 

NEXT 

FREE 


SECTOR ON THIS TRACK 

LAYOUT NEXT OPTIMUM 
SECTOR 

CHECK NUMBER OF FREE 
BLOCKS IN BAM FOR 
EVERY TRACK 

COMMAND TO CREATE OR 
SWITCH PARTITIONS- 

it ^ii 
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u 

u 

u 

u 

u 

u 

u 

u 

u 

u 

u 

o 

u 

u 

VJ 

O' 

o 

u 

u 

u 

o 

u 

u 

o 

Vj 

u 

u 

u 

u 

u 

u 

\J. 

o 

u 

u 

u 

o 

w 




n\ 

n 


r > 

LOCATION 

LABEL_ 

DESCRIPTION 

n 




O 

$B7F7- 

SETSUBDIR 

MOVE THROUGH SUB¬ 

r ^ 



DIRECTORIES TO ROOT 

n 



DIRECTORY 

n 

$B888- 

ILLEGALPART 

AN ILLEGAL PARTITION 

n 



WAS SELECTED 

n 

$B8D5- 

FASTLOAD 

FASTLOAD FILE OVER 1581 




BUS (PRG, SEQ, USR) 

n 

$B95F- 

XFERFAST 

FAST SECTOR TRANSFER 

n 

$B990- 

XFERLAST 

FAST LOAD LAST FILE 

n 



SECTOR 

n 

$B9D3- 

SHOWERR 

DISPLAY ERROR MESSAGES 






$B9DF- 

LOADERR 

LOAD ERROR 

n 




n 

$BA06- 

FNAMESETUP 

SHIFT FILE NAME TO 




BEGINNING OF INPUT 

n 



BUFFER 

n 

$BA40- 

SENDFAST 

BYTE SENT OVER 1581 BUS 

n 



FOR FAST LOAD 

ns 

$BA64- 

SETUPCRASH 

THIS ROUTINE SETS THE 

ns 



RAM ERROR VECTORS TO 




POINT TO ROM. THE 

f ^ 



VECTOR AT $01BA IS SET 

n 



TO $DFDF WHICH WILL 

ns 



CRASH THE DOS. 

n 

$BA7C- 

SAVEVEC 

STORE ERROR VECTORS IN 

ns 



SAVE VECTOR AREA 

ns 

$BA95- 

RESTOREVEC 

RETRIEVE ERROR VECTORS 




FROM SAVE VECTOR AREA 

n 




ns 

$BAB3- 

BURSTREAD 

BURST READ TRACK AND 




SECTOR HANDLER 

n 




n 

$BAD6- 

BURSTREAD2 

BURST READ NUMBER OF 




SECTORS HANDLING 

n 



ROUTINE 

n 

$BAF7- 

IDMISMATCH 

DISK ID MISMATCH ERROR 

n 




n 

$BAF9- 

DRVNOTREADY 

DRIVE NOT READY ERROR 


n 
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VJ 




vj 

LOCATION 

LABEL 

DESCRIPTION 

vj 




vj 

$BAFC- 

COMMSTERROUT 

COMBINE COMMAND STATUS 

VJ 



FLAG AND OUTPUT WITH 
ERROR 

VJ 




vj 

$BB02- 

EVENTERR 

EVENTUAL ERROR OUTPUT 
(OTHERWISE RETURN) 

vj 



VJ 

$BBOA- 

DOERRINXR 

OUTPUT ERROR MESSAGE 
NUMBER (NUMBER IN .XR) 

vj 



VJ 

$BB11- 

BURSTREADCMD 

BURST READ COMMAND 

u 

$BC01- 

BURSTWRTCMD 

BURST WRITE COMMAND 

o 

$BCB2- 

INQUIREDISK 

BURST COMMAND INQUIRE 

vj 



DISK 

vj 

$BD06- 

MOREVALUES 

VALUES $00, $10, $0A, 

u 



$05 

VJ 

$BDOA- 

DRVNOTREADY 2 

DRIVE NOT READY ERROR 

VJ 




vj 

$BD12- 

BURSTFORMAT 

BURST FORMAT COMMAND 

vj 

$BD4A-$BD5D 

FORMATSTRING 

"NO:COPYRIGHT CBM,86" 

Vj 



IN ASCII (USED TO DO 



1581 DEFAULT BURST 

VJ 



FORMAT) 

VJ 

$BD5E- 

FORMATSTANDARD 

FORMAT USING STANDARD 

vj 



DOS FORMAT VIA BURST 
FORMAT COMMAND 

Vj 




vj 

$BD7C- 

CUSTOMFORMAT 

CUSTOM FORMAT VIA BURST 

vj 



FORMAT COMMAND/SETUP 



FORMAT VARIABLES 

vj 

$BDF8- 

MOREVALUES2 

VALUES $0E, $16, $26, 

vj 



$44 

u 

$BDFC- 

SYNTAXERR 

SYNTAX ERROR 

VJ 




VJ 

$BE06- 

QUERYDISK 

BURST QUERY DISK FORMAT 

vj 



COMMAND. 

$BE79- 

SENDQUERY 

SEND OUT THE RESULTS 

VJ 



OF THE QUERY DISK 

VJ 



FORMAT 

o 




VJ 




VJ 
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VJ 




VJ 



rs 

n 

r\ 

n 

n 

o 

o 

o 


n 

n 

o 

r*\ 

n 

r^ 

o 

r^ 

/•v 

n 

n 

r^ 

o 
o 
n 
r\ 
r ^ 

r^ 

r^ 

r*\ 


LOCATION 


LABEL 

DESCRIPTION 

$BEBB- 


INQUIRESTATUS 

BURST INQUIRE STATUS 
COMMAND 

$BEF1- 


SETSTATUS 

SET COMMAND STATUS BYTE 

$BEF8- 


SYNTAXERR 

SYNTAX ERROR 

$BF02- 


DUMPCACHE 

BURST COMMAND DUMP 
TRACK CACHE BUFFER 

$BF66- 


PREPERROUT 

PREPARE ERROR BYTE 
OUTPUT 

$BF7F- 


PREPDATA 

VALUES $00, $10, $20, 

$30 

$BF86- 


SENDBYTEFAST 

SEND BYTE OVER SERIAL 
BUS USING BURST 

PROTOCOL 

$BFE3- 


DUMPTRK 

DUMP A TRACK FROM CACHE 
BUFFER TO DISK 

$C097- 


SMTOGRT 

DETERMINE SMALLEST AND 
GREATEST SECTOR 

NUMBERS 

$C0BE- 


JMPCTRLER 

JUMP TO THE DISK 
CONTROLLER ROUTINE 

$C163-$C183 

CTRLBYTES 

DRIVE CONTROLLER 

BYTES/CODES CONTAINING 
8 FLAG BITS FOR EACH 
OF THE 33 AVAILABLE 
JOBS 

- 

BI3L 

TEXT 


7 

6 

TRANSLATE 
CACHE OUT 

TRACK AND SECTOR 


5 START MOTOR 

4 WAIT UNTIL MOTOR IS UP TO SPEED 

3 SEEK TRACK 

2 CHECK CACHE DIRTY 

1 STEP REQUIRED 

0 SIDE SELECT 
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U 






U 

LOCATION 

LABEL 


DESCRIPTION 

u 






o 

$C184-$C1A4 

CTRLBYTES2 

DRIVE 

CONTROLLER 

u 



BYTES/CODES 

CONTAINING 

u 



3 MORE 

FLAG BITS FOR 



EACH 

0 F 

THE 3 3 

V. J 



AVAILABLE JOBS 

o 

BIT 

TEXT 




o 

7 

BY-PASS 

TRACK AND 

SECTOR 

u 


TRANSLATION 



u 

6 

LOGICAL/PHYSICAL 

FLAG 


u 

5 

READ/WRITE OPERATOR 







U 

$C1A5-$C1E7 

JOBCMDS 

JOB QUEUE 

COMMAND 

^J 



VECTORS 








u 


NAME 

COMMAND 

NUMBER 


$C1A5- 

READ DV 

$80 


$C900 

u 

o 

$C1A7- 

RESET DV 

$82 


$C2E7 

$C1A9- 

MOTON DV 

$84 


$C390 

o 

$C1AB- 

MOTOFF DV 

$86 


$0393 

VJ 

$C1AD- 

MOTONI DV 

$88 


$0396 

$C1AF- 

MOTOFFI DV 

$8A 


$C3A9 

o 

$C1B1- 

SEEK DV 

$8C 


$C3AF 

o 

$C1B3- 

FORMAT DV 

$8E 


$C3BB 

$C1B5- 

WRSTD DV 

$90 


$0900 

u 

SC1B7- 

DISKIN DV 

$92 


$C6D7 

u 

$C1B9- 

LEDACTON DV 

$94 


$0546 

$C1BB- 

LEDACTOFF DV 

$96 


$C54F 

o 

$C1BD- 

ERRLEDON DV 

$98 


$0558 

o 

$C1BF- 

ERRLEDOFF DV 

$9A 


$0561 

$C1C1- 

SIDE DV 

$9C 


$C56A 

o 

$C1C3- 

BUFMOVE DV 

$9E 


$0589 

O 

$C1C5- 

WRTVER DV 

$A0 


$C9E1 

$C1C7- 

TRKWRT DV 

$A2 


$C5AC 

o 

$C1C9- 

SP READ 

$A4 


$0800 

o 

$C1CB- 

SP WRITE 

$A6 


$0700 

$C1CD- 

PSEEK DV 

$A8 


$C6D7 

u 

$C1CF- 

TREAD DV 

$AA 


$CB09 

$C1D1- 

TWRT DV 

$AC 


$CAE4 

o 

$C1D3- 

SEEKHD DV 

$B0 


$CBOF 

u 

$C1D5- 

TPREAD DV 

$B2 


$CB26 

$C1D7- 

TPWRT DV 

$B4 


$CB26 

o 

$C1D9- 

DETWP DV 

$B6 


$CB35 

u 

$C1DB- 

SEEKPHD DV 

$B8 


$0900 

$C1DD- 

RESTORE DV 

$C0 


$0900 

o 

$C1DF- 

JUMPC DV 

$D0 


$0900 

o 

$C1E1- 

EXBUF DV 

$E0 


$0900 

$C1E3- 

FORMATDK DV 

$F0 


$CB76 

u 






o 
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o 





n 
o 
n 
r ^ 
n 
n 
n 
n 
rN 
r* 
n 
n 
n 
n 

r\ 
r > 

n 

r*\ 

n 

n 

n 

r% 

n 

n 

n 

n 

ns 

ns 

ns 

n 

n 

r\ 

ns 

n\ 

n 

n 

n\ 

n 




$C1E5- 

CTRLERR_DV 

NONE $CB85 

$C1E7-$C2E6 

DATABYTES 

EIGHT DATA BYTES FOR 
EACH OF THE CONTROLLER 
COMMANDS LISTED 

ABOVE/JOB INDEX FOR 33 
JOBS 

$C2E7- 

JOBRESET 

RESET COMMAND - RESETS 
THE DISK CONTROLLER 
AND VARIABLES ($82) 

$C30C- 

SETWDCMDS 

RESTORE DEFAULT WD177X 
COMMMAND TABLE 

$C390- 

JOBMOTON 

MOTOR ON COMMAND- 
TURNS ON THE DRIVE 
SPINDLE MOTOR ($84) 

$C393- 

JOBMOTOFF 

MOTOR OFF COMMAND- 
TURNS OFF THE DRIVE 
SPINDLE MOTOR ($86) 

$C396- 

JOBMOTONI 

MOTOR ON IMMEDIATELY 
($88) 

$C3A9- 

JOBMOTOFFI 

MOTOR OFF IMMEDIATELY 
($8A) 

$C3AF- 

JOBSEEKTRK 

SEEKS TRACK COMMAND 
($8C) 

$C3BB- 

JOBFORMATTRK 

FORMAT ONE PHYSICAL 
TRACK ($8E) 

$C3EC- 

WRTINDEX 

WRITE TRACK INDEX/SAVE 
AFTER INDEX HOLE 

$C52C- 

STOP1TRKFORMAT 

TERMINATE PHYSICAL 
TRACK FORMAT 

$C546- 

JOBACTLEDON 

TURN ON DISK ACTIVITY 
LED ($94) 

$C54F- 

JOBACTLEDOFF 

TURN OFF DISK ACTIVITY 
LED ($96) 

$C558- 

JOBERRLEDON 

TURN ON DISK ERROR LED 
($98) 
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u 
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u 




o 

$C561- 

JOBERRLEDOFF 

TURN OFF DISK ERROR LED 

o 



($9A) 

o 

$C56A- 

JOBSETSIDE 

SET UP SIDE SELECT 

o 



ELECTRONICS TO THE 
VALUE IN THE SIDES 

o 



TABLE. ($9C) 

O' 

$C589- 

JOBMOVEDATA 

MOVE DATA BETWEEN THE 

o 



JOB QUEUE BUFFERS AND 

o 



TRACK CACHE ($9E) 

o 

$C5AC- 

JOBDUMPCACHE 

DUMPS TRACK CACHE TO 

u 



DISK (IF "DIRTY") 
($A2) 

o 

$C5AF-$C5FF 



u 


NOT USED BY DOS 

u 

$C600- 

DUMPOLD 

DUMP OLD TRACK CACHE 

o 



DATA 




o 

$C6D7- 

DUALJOB 

CHECKS TO SEE IF A DISK 

o 



IS IN THE DRIVE AND 



SEEKS A PRESET 

o 



PHYSICAL TRACK ($92 

AND $A8) 

o 




o 

$C6DD-$C6FF 


NOT USED BY DOS 

o 

$C700- 

JOBWRTPHYS 

WRITE A PHYSICAL SECTOR 

o 



DIRECTLY ($A6) 

G 

$C765-$C7FF 


NOT USED BY DOS 

o 

$C800- 

JOBREADPHYS 

READ A PHYSICAL SECTOR 

o 



DIRECTLY ($A4) 

o 

$C865-$C8FF 


NOT USED BY DOS 

u 




u 

SC900- 

MULTIJOB 

EXECUTES CONTROLLER 

u 



COMMANDS FOR: 




o 



READING SECTORS ($80) 
WRITING SECTORS ($90) 

o 



SEEKING HEADERS ($B8) 

BUMP TO TRACK 0 ($C0) 

o 



EXECUTE PROGRAM ($D0) 

o 



EXECUTE BUFFER ($E0) 

o 




o 




o 

° Copyright 

1988 D. W. Martin All Rights Reserved. 

VJ 

The 1581 DOS 

Reference Guide 

-95- Chapter 8 

o 
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o 



n 




n 





LOCATION 

LABEL 

DESCRIPTION 

n 





$C9E1- 

JOBVERCACHE 

VERIFY CACHE DATA 

n 



AGAINST A LOGICAL 
TRACKS DATA ($A0) 

n 



n 

$C9F6-$C9FF 


NOT USED BY DOS 


$CAOO- 

FORMATVER 

VERIFY DISK FORMAT 


$CAE4- 

JOBWRTLOG 

WRITE A LOGICAL ADDRESS 




WITHOUT TRANSFER FROM 




JOB QUEUE BUFFER ($AC) 


$CB09- 

JOBREADLOG 

READ A LOGICAL ADDRESS 

n 



WITHOUT TRANSFER FROM 
JOB QUEUE BUFFER ($AA) 





n 

$CBOF- 

JOBREADHDR 

READ HEADER DATA FROM 



FIRST DISK SECTOR 

n 



FOUND ($B0) 


$CB26- 

JOBWRTPHYS 

WRITE A PHYSICAL 

n 



ADDRESS WITHOUT 

TRANSFER FROM JOB 

QUEUE BUFFER ($B2) 

n 

$CB26- 



o 

JOBREADPHYS 

READ A PHYSICAL ADDRESS 



WITHOUT TRANSFER FROM 

n 



JOB QUEUE BUFFER ($B4) 


$CB35- 

J OBWRTPROTECT 

CHECKS TO SEE IF THE 

o 



CURRENT DISK IS WRITE 

o 



PROTECTED ($00 = NO, 

$08 = YES) ($B6) 

o 

$CB76- 

JOBFORMATDSK 

FORMAT THE DISK WITH 

n 



THE DEFAULT PHYSICAL 

n 



FORMAT ($F0) 


$CBB1- 

MOTORON 

SPINDLE MOTOR ON 

rs 

$CBBA- 

MOTOROFF 

SPINDLE MOTOR OFF 

n 




o 

$CBC3- 

ACTLEDOFF 

GREEN ACTIVITY LED OFF 

r^ 

$CBCC- 

ACTLEDON 

GREEN ACTIVITY LED ON 


$CBEC- 

WDCMDWAIT 

WAIT UNTIL CURRENT 

n 



COMMAND ON WD177X IS 
DONE 
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U 




u 

LOCATION 

LABEL 

DESCRIPTION 

u 




u 

$CBF4- 

EXECWDCMD 

EXECUTE WD177X COMMAND 

u 

$CC02-$CCFF 


NOT USED BY DOS 

o 




u 

$CDOO- 

FINDHDR 

SEEK A DISK HEADER 

u 

$CD3F- 

WDSTATUS 

GET WD177X CONTROLLER 

o 



STATUS 

o 

$CD5A-$CD62 

WDSTDATA 

VALUES $00, $05, $02 

o 



$00, $00, $00 



$00, $00, $08 

o 

$CD63- 



^J 

STARTMOT 

FIRE UP THE DISK DRIVE 




MOTOR 

^J 

$CD7B- 

UPTOSPEED 

WAIT TILL THE MOTOR IS 

o 



UP TO SPEED 

o 

$CDBC- 

DRVRDY 

CHECK FOR DRIVE READY 

O 




o 

$CEDC- 

LOG2PHYS 

LOGICAL TO PHYSICAL 

V.J 



SECTOR TRANSLATION 



ROUTINE 

O 

$CE71- 

STEPSET 

ROUTINE FOR HEAD 

o 



STEPPING AND SETTLING 


$CFD1- 

FORCEWDIRQ 

FORCE INTERRUPT ON 

u 



WD177X, DO A DELAY, 
WAIT TILL COMMAND IS 

DONE 

O' 




o 

$D00D-$D03D 

LAZY1 

FIRST DOS "LAZY" 

o 



MESSAGE 




o 



"AM I LAZY???...NO 

o 



JUST WANTED TO SAVE A 



FEW MS..." 

o 

$D03E-$D53D 

NOTHING1 

COPIES WHAT POINTED TO 

o 



BY $48 TO WHATS 

POINTED TO BY $4A 

o 



INDEXED BY .YR 


$D549-$D557 

LAZY 2 

SECOND AND LAST DOS 

o 



"LAZY" MESSAGE "THIS 

o 



IS LAZY!!!" 

o 

$D558-$DA57 

NOTHING2 

SEE LOCATION $D03E 

o 




o 
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o 
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n 



n 



n 

LOCATION 

LABEL 

n 



n 

$DA63- 

CHKSUM 

n 



n 



n 

$DAFD- 

IRQRTN 

n 

$DB36-$DB75 

USERADDR 

n 



n 

n 

$DB36- 

$DB38- 

$DB3A- 


n 

$DB3C- 


n 

$DB3E- 


n 

$DB40- 


n 

$DB42- 


n 

$DB44- 


n 

$DB46- 


n 

$DB48- 


n 

$DB4A- 


n 

$DB4C- 

$DB4E- 


n 

$DB50- 


n 

$DB52- 

$DB54- 


n 

$DB56- 


n 

$DB58- 

$DB5A- 


n 

$DB5C- 


n 

$DB5E- 


n 

$DB60- 


n 

$DB62- 


n 

$DB64- 


n 

$DB66- 


n 



n 

$DB68- 


n 



n 

$DB6A- 


n 

$DB6C- 


n 

$DB6E- 


n 




DESCRIPTION 


ROUTINE TO DO THE 
CYCLIC REDUNDANCY 
CHECKSUM 

1581 IRQ ROUTINE 

ADDRESSES OF COMMAND 
ROUTINES FOR USERO 

$BB11 - BURST READ SECTOR 
SBAFA - DRIVE NOT READY 
$BC01 - BURST WRITE SECTOR 
$BBF9 - DRIVE NOT READY 
$BCB2 - BURST READ SECTOR 
HEADER 

$BAFA - DRIVE NOT READY 
$ BD12 - BURST FORMAT 

DISKETTE 

$ B D12 - BURST FORMAT 

DISKETTE 

$BDFC - SYNTAX ERROR #31 
$BDFC - SYNTAX ERROR #31 
$BE06 - BURST DETERMINE 

SECTOR SEQUENCE 
$BAFA - DRIVE NOT READY 
$BEBB - BURST INQUIRE STATUS 
$BAFA - DRIVE NOT READY 
$BEF8 - SYNTAX ERROR #31 
$BEF8 - SYNTAX ERROR #31 
$BB11 - BURST READ SECTOR 
$BAFA - DRIVE NOT READY 
$BC01 - BURST WRITE SECTOR 
$BBF9 - DRIVE NOT READY 
$BCB2 - BURST READ SECTOR 
HEADER 

$BAFA - DRIVE NOT READY 
$ BD12 - BURST FORMAT 

DISKETTE 

$ B D12 - BURST FORMAT 

DISKETTE 

$89CB - RTS INSTRUCTION NO 
FUNCTION 

$89CB - RTS INSTRUCTION NO 
FUNCTION 

$BE06 - BURST DETERMINE 

SECTOR SEQUENCE 
$BAFA - DRIVE NOT READY 
$BF02 - READ NEXT SECTOR 
HEADER 
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-LQC^IOH 

$DB70- 

$DB72- 

$DB74- 

$DB76- 

$DB77- 

$DB78-$DB83 

$DB84-$DB8F 

$DB90-$DB9B 


$DB9C-$DBA0 


LAP-EX'- DESCRIPTION 


$BF02 - READ NEXT SECTOR 
HEADER 

$AA3C - EXECUTE 1581 STATUS 
COMMAND 

$B8D5 - FAST LOAD A FILE 

OVER THE 1581 BUS 

NUMBER OF BYTES IN BAM 
FOR EACH DISK TRACK 
($06/6) 

DISK NAME OFFSET IN BAM 
($04/4) 


BAMUSE 


NAMEOFFSET 


DOSCMDTABLE TABLE OF DOS COMMANDS 

V/ I, /, M, B, U, P, 
&, C, R, S, N 


DOSCMDLO 


DOS COMMAND VECTORS LOW 
BYTES 


DOSCMDHI 


DOS COMMAND VECTORS 
HIGH BYTES 


V - $FF09 
/ - $FF0F 
B - $FF15 
P - $FF1B 
C - $FF21 
S - $FF27 


I - $FF0C 
M - $FF12 
U - $FF18 
& - $FF1E 
R - $FF24 
N - $FF2A 


CMDIMAGES STRUCTURE IMAGES FOR 

DOS COMMANDS 


$51 - DISK COPY 
$DD - RENAME A FILE (NOT 
PARSED) 

$1C - SCRATCH A FILE (NOT 
PARSED) 

$9E - FORMAT A DISK (NOT 
PARSED) 

$1C - LOAD A FILE 
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O' 

<J 
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u 
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o 
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u 

<J 
<J 

u 

^J 
<J 
V .J 

V .J 

KJ 
K.J 

u 

u 

u 

u 



n 

n 

n 

n 

n 

n 

n 

n 

n 

r*\ 

n 

n 

n 

o 

n 

n 

n 

o 

n\ 

o 

n 

r^ 

n 

n 

n 

n 

n 

n 

n 

n 

n 



$DBA1-$DBA4 

FILEMODE 

MODE TABLE 

$DBA1- $52 R = READ MODE 

$DBA2- $57 W = WRITE MODE 

$DBA3- $41 A = APPEND MODE 

$DBA4- $4D M = MODIFY MODE 
(READ AN IMPROPERLY CLOSED 
FILE) 

$DBA5-$DBBC 

FILETYPE 

FILE TYPE TABLE 


FTO 

$DBA5-$DBAA FIRST BYTE 
OF FILE TYPE (D, S, 
P, U, L, C) FOR FILE 
OPERATIONS 


FT1 

$DBAB-$DBB0 FIRST BYTE 
OF FILE TYPE (D, S, 
P, U, R, C) 


FT 2 

$ DBB1-$DBB6 SECOND 
BYTE OF FILE TYPE (E, 
E/ R/ S, E, B) 


FT 3 

$DBB7-$DBBC THIRD BYTE 
OF FILE TYPE (L, Q, 
G, R, L, M) 

VALID FILE TYPES ARE: 
DEL, SEQ, PRG, USR, 
REL, CBM 

$DBBD-$DBC1 

ERRFLAG 

ERROR FLAG VARIABLES 
FOR USE BY BIT 

COMMANDS 

$DBC2-$DBC6 

ERROFFSETS 

OFFSETS FOR ERROR 
RECOVERY 

$DBC7- 

SPINPATCH 

SPIN ROUTINE PATCH TO 
CLEAR THE SHIFT 

REGISTER 

$DBE0- 

SPOUTPATCH 

SPINOUT ROUTINE PATCH 
TO CLEAR THE SHIFT 


REGISTER 
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IQGMJSW. 


LABEL 


$DBEE- 

$DBF4- 

$DC01-$DC37 

$DC38-$FEFF 

$FFOO- 

$FF03- 

$FF06- 

$FF09- 

$FFOC- 


° Copyright 
The 1581 DOS 


DESCRIPTION 


RELEASESEC 

RELEASE SECTORS IN BAM 
AFTER SCRATCHING A 
FILE/USED AFTER 

SCRATCHING A PARTITION 
FILE TO UPDATE THE 
DISK BAM 

SEEKNCHK 

SEEK A HEADER AND CHECK 
DISK FORMAT 

CRMSG 

COMMODORE DOS COPYRIGHT 
MESSAGE 

”(C)1987 COMMODORE 
ELECTRONICS LTD., ALL 
RIGHTS RESERVED" 

NOT USED BY THE DOS 

IDLE 

EXECUTE THE JIDLE 
ROUTINE VIA AN 

INDIRECT JUMP TO THE 
VECTOR AT $0190. JIDLE 
AT $B0F0 

IRQ 

EXECUTE THE JIRQ 

ROUTINE VIA AN 

INDIRECT JUMP TO THE 
VECTOR AT $0192. JIRQ 
AT $DAF0 

NMI 

EXECUTE THE JNMI 
ROUTINE VIA AN 

INDIRECT JUMP TO THE 
VECTOR AT $0194. JNMI 
AT $AFCA 

VERDIR 

EXECUTE THE JVERDIR 
ROUTINE VIA AN 

INDIRECT JUMP TO THE 
VECTOR AT $0196. 

JVERDIR AT $B262 

INTDRV 

EXECUTE THE JINTDRV 
ROUTINE VIA AN 

INDIRECT JUMP TO THE 
VECTOR AT $0198. 
JINTDRV AT $8EC5 
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v .J 
V .J 
^J 
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KJ 
^J 

KJ 

KJ 

^J 
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n 
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n 
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LOCATION 

LABEL 

DESCRIPTION 

$FF0F- 

PART 

EXECUTE THE JPART 
ROUT INE VIA AN 

INDIRECT JUMP TO THE 
VECTOR AT $019A. JPART 
AT $B781 

$FF12- 

MEM 

EXECUTE THE JM EM 

ROUTINE VIA AN 

INDIRECT JUMP TO THE 
VECTOR AT $019C• JMEM 
AT $892F 

$FF15- 

BLOCK 

EXECUTE THE JBLOCK 
ROUTINE VIA AN 

INDIRECT JUMP TO THE 
VECTOR AT $ 019 E• 
JBLOCK AT $8A5D 

$FF18- 

USERVEC 

EXECUTE THE JUSER 
ROUTINE VIA AN 

INDIRECT JUMP TO THE 
VECTOR AT $01A0. JUSER 
AT $898F 

$FF1B- 

RECORD 

EXECUTE THE JRECORD 
ROUTINE VIA AN 

INDIRECT JUMP TO THE 
VECTOR AT $ 0 1 A2 • 

JRECORD AT $A1A1 

$FF1E- 

UTLODR 

EXECUTE THE JUTLODR 
ROUTINE VIA AN 

INDIRECT JUMP TO THE 
VECTOR AT $ 01A4 • 

JUTLODR AT $A956 

$FF21- 

DSKCOPY 

EXECUTE THE JDSKCPY 
ROUTINE VIA AN 

INDIRECT JUMP TO THE 
VECTOR AT $ 0 1 A6 . 
JDSKCPY AT $876E 

$FF24- 

RENAMEVEC 

EXECUTE THE JRENAME 
ROUTINE VIA AN 

INDIRECT JUMP TO THE 
VECTOR AT $ 0 1A8 • 
JRENAME AT $88C5 


° Copyright 1988 D. W. Martin All Rights Reserved. 
The 1581 DOS Reference Guide -102- Chapter 8 






VJ 




vj 

LOCATION 

LABEL 

DESCRIPTION 

u 

vj 




$FF27- 

SCRTCH 

EXECUTE THE JSCRTCH 

u 



ROUTINE VIA AN 



INDIRECT JUMP TO THE 

VJ 



VECTOR AT $ 01AA. 

JSCRTCH AT $8688 

VJ 



vj 

$FF2A- 

NEW 

EXECUTE THE JNEW 

vj 



ROUTINE VIA AN 



INDIRECT JUMP TO THE 

VJ 



VECTOR AT $ 01AC. JNEW 

AT $B348 

V J 




vj 

$FF2D- 

ERROR 

EXECUTE THE ERROR 

VJ 



ROUTINE VIA AN 



INDIRECT JUMP TO THE 
VECTOR AT $01AE• ERROR 

AT $A7AE 

VJ 

VJ 

$FF30- 



VJ 

ATNSERV 

EXECUTE THE JATNSRV 

VJ 



ROUTINE VIA AN 



INDIRECT JUMP TO THE 
VECTOR AT $ 01B0• 
JATNSRV AT $ABCF 

VJ 

V J 

$FF33- 



vj 

TALK 

EXECUTE THE JTALK 

VJ 



ROUTINE VIA AN 



INDIRECT JUMP TO THE 
VECTOR AT $01B2• JTALK 

vj 



AT $AD5C 

VJ 

$FF36- 

LISTEN 

EXECUTE THE JLISTEN 

VJ 



ROUTINE VIA AN 

vj 



INDIRECT JUMP TO THE 
VECTOR AT $ 01B4 . 

vj 



JLISTEN AT $AEB8 

vj 

$FF39- 

LCC 

EXECUTE THE JLCC 

vj 



ROUTINE VIA AN 

vj 



INDIRECT JUMP TO THE 
VECTOR AT $01B6. JLCC 

VJ 



AT $COBE 

VJ 

$FF3C- 

TRANSTS 

EXECUTE THE JTRANS TS 

VJ 



ROUTINE VIA AN 

VJ 



INDIRECT JUMP TO THE 
VECTOR AT $ 01B 8 . 

vj 



JTRANSJTS AT $CEDC 

VJ 




VJ 




VJ 




VJ 
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LOCATION LABEL, 


$FF3F- 

CMDERR 

EXECUTE THE CMDERR 
ROUTINE VIA AN 

INDIRECT JUMP TO THE 
VECTOR AT $01 BA. 
CMDERR AT $A7F1 

$FF42-$FF53 


NOT USED BY DOS 

$FF54- 

STROBECTRLER 

EXECUTE THE 

JSTROBE CTRLER ROUTINE 
VIA A DIRECT JUMP TO 
$FF54 JSTROBE CTRLER 
AT $959D 

$FF57- 

CBMBOOT 

EXECUTE THE JCBMBOOT 
ROUTINE VIA A DIRECT 
JUMP TO $FF57 JCBMBOOT 
AT $A938 

$FF5A- 

CBMBOOTRTN 

EXECUTE THE JCBMBOOTRTN 
ROUTINE VIA A DIRECT 
JUMP TO $ F F 5 A 

JCBMBOOTRTN AT $A94C 

$FF5D- 

SIGNATURE 

EXECUTE THE JSIGNATURE 
ROUTINE VIA A DIRECT 
JUMP TO $ F F 5 D 

JSIGNATURE AT $AB1D 

$FF60- 

DEJAVU 

EXECUTE THE JDEJAVU 
ROUTINE VIA A DIRECT 
JUMP TO $FF60 JDEJAVU 
AT $9145 

$FF63- 

SPINOUT 

EXECUTE THE JSPINOUT 
ROUTINE VIA A DIRECT 
JUMP TO $FF63 JSPINOUT 
AT $AEEA 

$FF66- 

ALLOCBUFF 

EXECUTE THE JALLOCBUFF 
ROUTINE VIA A DIRECT 
JUMP TO $ F F 6 6 

JALLOCBUFF AT $8C5C 

$FF69- 

TESTTRKSEC 

EXECUTE THE JTESTTRKSEC 
ROUTINE VIA A DIRECT 
JUMP TO $ F F 6 9 


JTESTTRKSEC AT $9460 
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U 

-LQCmQN- 

LABEL 

DESCRIPTION 

u 




u 

$FF6C- 

DUMPTRK 

EXECUTE THE DUMP TRACK 

u 



TO DISK ROUTINE AT 
$BFE3 

o 



^J 

$FF6F-$FF74 


NOT USED BY DOS 

u 

$FF75-$FFA0 

RAMVECDATA 

VECTORS FOR RAM JUMP 

u 



TABLE AT $0190 

(DEFAULTS SEE $FF00- 

O' 



$FF3F ABOVE) 

o 

$FFA1-$FFAC 


NOT USED BY DOS 

o 




o 

$FFAD- 

INITJMP 

ROUTINE TO INITIALIZE 

o 



RAM JUMP TABLE AT 



$0190 

o 

$FFC8-$FFE9 


NOT USED BY DOS 

o 




o 

$FFEA-$FFFF 

USRJMP 

USER COMMAND JUMP TABLE 

o 

$FFEA- 

USER1 

"Ul/A" VECTOR POINTS TO 

o 



$8B9A 

o 

$FFEC- 

USER2 

"U2/B" VECTOR POINTS TO 

o 



$8BD7 

o 

$FFEE- 

USER3 

"U3/C" VECTOR POINTS TO 

o 



$0500 




o 

$FFF0- 

USER4 

"U4/D" VECTOR POINTS TO 

o 



$0503 




o 

$FFF2- 

USER5 

"U5/E" VECTOR POINTS TO 
$0506 

u 




o 

$FFF4- 

USER6 

"U6/F" VECTOR POINTS TO 

o 



$0509 




o 

$FFF6- 

USER7 

"U7/G" VECTOR POINTS TO 

o 



$050C 




o 

$FFF8- 

USER8 

"U8/H" VECTOR POINTS TO 

o 



$050F 




o 

$FFFA- 

NNMI 

"U9/I" NNMI ROUTINE 

o 



POINTS TO $AD3C 




o 

$FFFC- 

DSKINT 

"U:/J" DSKINT ROUTINE 

o 



POINTS TO $AF24 

o 

o 
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$FFFE- SYSIRQ 


"UK" SYSIRQ ROUTINE 
POINTS TO $FF03 

( SENDING A "UK" 
COMMAND CRASHES THE DRIVE) 
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Chapter, 9 - Miscellaneous 
-gQwerz HR Diagnostics 


The 1581 perforins a series of self-tests on 
power-up of the RAM, ROM and Controller. If a failure 
is detected, the DOS will blink all the LED's a 
specific number of times. The flashing code repeats 
continuously. 


Humber of Flashes 

1 

2 

3 


■JbbP- ur ce 
Zero Page 
ROM 

$1000-$1FFF 


8K X 8 RAM 
25256 ROM 
8K X 8 RAM 


An additional test performed by the 1581 is the 
controller test. If a controller failure is 
encountered the error channel will contain M 76, 
CONTROLLER ERROR,00,00. " 


If an extensive test of the ROM is needed, the 
1581 provides a signature analysis via the command 
M U0>T. M If a failure is detected the LED's will 
blink 4 times continuously. 


* * * 


TRACK CACHE BUFFER 

The 1581 disk drive has two read/write heads, 80 
disk cylinders, ten 512 byte sectors per cylinder and 
10,240 usable data bytes per cylinder. Although the 
disk is physically organized in 512 byte sectors, the 
DOS reguests data in 256 byte chunks. The controller 
interprets the DOS sector request and translates the 
logical request to a physical request on the 
diskette. The track and sector translation routine 
may be revectored by the user (This feature might 
make custom formats possible). 

All I/O to the diskette is implemented as an 
entire track access. This allows access to the drive 
with no interleaving. When a sector is read the drive 
has to only copy the data from the track cache buffer 
to one of the job queue buffers. If the requested 
sector appears on another track then that track is 
read into the cache buffer. Note, that if the track 
cache buffer contains data from a previously read 
track and some of that data has been changed, then 
the old data is written back to the diskette before 
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the new data is read in. 

Dumping of the track cache buffer is automatic, 
but it can be manually controlled. The track cache is 
dumped if the next physical request is for another 
track, a dump track buffer command is executed, or 
after 250 ms of idle serial bus activity. 

* * * 

- 3^8a_ 3-ERJ_AL_BUS SPECIFICATIONS 

The Commodore 1581 serial bus supports standard, 
fast and fast serial communications just like the 
1571. 

A Host Request Fast (HRF) command places the 
drive in fast serial mode. The 1581 remains in fast 
serial mode until it receives one of the following: 
Unlisten, Untalk, or a serial bus error. The HRF 
command generates a message that lets the host know 
that the addressed peripheral can receive bytes fast 
or slow. 

The heart of the 1581's serial communication 
abilities is the 8520A 2 mhz CIA chip. This chip 
contains a programmable baud rate generator which is 
used for fast serial transfers on the 1581. 

Timer A of the 8520A is used for the baud rate 
generator. In the output mode data is shifted out on 
the serial bus pin five (data) at half the underflow 
rate of Timer A and pin five will go low. The maximum 
baud rate possible is phi two divided by four, but 
the maximum usable baud rate will be determined by 
line loading and the speed at which the receiver 
responds to the input data. 

Transmission of data will start following a 
write to the Serial Data Register (only if Timer A is 
running and in continuous mode). The clock derived 
from Timer ' A appears on the serial bus pin four 
(clock). The data in the Serial Data Register will be 
loaded into the shift register then shifted out to 
serial bus pin five (data). 

After eight pulses on serial bus pin four 
(clock), a bit is set in the Interrupt Control 
Register and if desired an interrupt may be 
generated. Note, that all incoming data bytes cause 
an interrupt in the fast serial drive and that bytes 
are shifted out with the most significant bit first. 
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The following table lists the possible baud 
rates: 

BAUD RATE HI TIMER VALUE WW-EBBER VJWffli- 


166K 

00 

06 

143K 

00 

07 

100K 

00 

10 

50K 

00 

20 

25K 

00 

40 

12.5K 

00 

80 


NOTE: Values are clocked at a 2 mhz clock speed. 

* * * 


SER I AL -BU S _ P X N _OUy_ 


PIH JfflMBJBR- NAME PESC^im gJl 


1 SRQ SERVICE REQUEST. FAST SERIAL 

WILL USE THIS LINE AS A TWO 
DIRECTION FAST CLOCK LINE. 


2 


GND GROUND CONNECTION 


3 


4 



ATN ATTENTION SIGNAL. IDENTIFIES 

CONTROLLER COMMANDS. NO 
RESPONSE YIELDS DEVICE NOT 
PRESENT ERROR (IN ONLY) 

CLOCK USED FOR TIMING THE DATA 

SENT ON THE SERIAL BUS 
(SOFTWARE CLOCKED) (IN AND 
OUT) 

DATA DATA ON THE SERIAL BUS 

IS SENT ON BIT AT A TIME 

(SOFTWARE TOGGLED) . THIS 
LINE IS WIRE "ORED" AND 
USED AS THE FAST DATA LINE 
TO COMPLIMENT THE FAST 
CLOCK ON THE SRQ LINE (IN 
AND OUT) 


6 


RESET RESETS THE PERIPHERAL 

UPON HOST RESET 


NOTE: The signal on pin 3 goes low when an ATN 
command is found and an interrupt is generated. The 
attention sequence is followed by an address or 
command. 
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SERIAL BUS COMHANDS/ADDRESSES 


The following 

table lists 

the 


(addresses) and gives 

their 

explanation: 


COMMAND NAME LABEL 

BINARY 

VALUE 


HOST REQUEST FAST 

HRF 

1111 

1111 







DEVICE REQUEST FAST 

DRF 

0000 

0000 


TALK ADDRESS 

TA 

010X 

XXXX 

r*\ 

LISTEN ADDRESS 

LA 

001X 

XXXX 

r ■n 






UNTALK 

UNTLK 

0101 

1111 






rs 

UNLISTEN 

UNLSN 

0011 

1111 


SECONDARY ADDR OPEN 

SAO 

1111 

YYYY 


SECONDARY ADDR CLOSE 

SAC 

1110 

YYYY 

n 






SECONDARY ADDR NORMAL 

SA 

011Z 

ZZZZ 


NOTE: The HRF and DRF use a fast byte clocked over 
the SRQ line. 

Device addresses (X XXXX above) for talk and 
listen can hold the following values: 


APP RE 3 - S J E S_ 
0 TO 3 
4 TO 7 
8 TO 11 
12 TO 30 


TO H CT IQM- 
INTERNAL DEVICES 
NORMAL CBM PRINTERS 
NORMAL DISK UNITS 
UNUSED 


Channel addresses (YYYY above) for open and 
close can hold the following values: 


ADDRESSES^ 

0 

1 

2 TO 14 


FPMCT IfiH- 

PROGRAM TYPE READ DATA CHANNEL 
PROGRAM TYPE WRITE DATA CHANNEL 
CHANNEL FOR ALL FILE TYPES (R/W) 
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ADDRESSES 


ELECTION 


15 COMMAND CHANNEL (R/W) 

NOTE: R/W means read/write. 

* * * 

-SECONDARY ADDRESS DESCRIPTIONS 


- AD DRESS, 

0 

1 

2 TO 14 

15 


DESCRIPTION 

LOAD CHANNEL (LOADING FILES) 

SAVE CHANNEL (SAVING FILES) 

OPEN A BUFFER OR BUFFERS 
DIRECT BUFFER ACCESS OR FILE 
ACCESS. EIGHT BUFFERS ARE AVAILABLE. 

COMMAND AND ERROR CHANNEL (SEND 
COMMANDS TO THE DRIVE OR READ 
THE ERROR CHANNEL) 


The normal secondary address (Z ZZZZ above) can 
be from zero to 31. 

* * * 

-STAND ARD KERNAL CALLS AND SERIAL BUS 

The following are a list of standard kernal 
calls and how they communicate with the 1581 serial 
bus. A few new terms have been added they are defined 
below to help you understand how the Kernal calls 


U 

u 

u 

V.J 

u 

u 

u 

O 
V.J 

o 

o 

L J 
^J 

o 

VJ 

o 

o 

o 

o 

u 

u 

u 

O' 

o 

o 

o 


work. 


O 

TERM 

DESCRIPTION 

o 



o 

DB 

DATA BYTE 

o 

FN 

FILE NAME BYTE 

o 

EOI 

END OR IDENTIFY HANDSHAKE 

o 

TKATN 

TALK/ATN HANDSHAKE 

o 


o 


* * * 

o 



o 



o 



o 
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LOAD FROM DISK - KERNAL_^iQML 
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This routine loads data bytes from any input 
device and places it directly into the hosts memory. 

HRF LA SAO FN1 FN2...FNn-l EOI FNn HRF UNLSN HRF 
TA SA 

TKATN DB1 DB2...DBn-l EOI DBn UNTLK HRF TA SAC 
HRF UNLSN 


* * * 

SAVE TO DISK - KERNAL _SAVE_ 

This routine saves a section of memory from the 
host to a diskette. 

HRF LA SAO FN1 FN2...FNn-1 EOI FNn HRF UNLSN HRF 
LA SA 

DRF DB1 DB2...DBn EOI DBn-1 HRF UNLSN HRF LA SAC 
HRF 

UNLSN 


* * * 

OPEN WITH SECONDARY ADDRESS - KgRNAL . OP_EN_ 

This routine is used to open a logical file for 
I/O operations. 

HRF LA SAO DRF FN1 FN2...FNn-1 EOI FNn HRF UNLSN 

* * * 

CLOSE WITH SECONDARY ADDRESS, - KEBNAL_C_LO_SE_ 

This routine is used to close a logical file 
after all I/O operations have been completed on that 
file. 


HRF LA SAC HRF UNLSN 

* * * 


° Copyright 1988 D. W. Martin All Rights Reserved. 
The 1581 DOS Reference Guide -112- Chapter 9 



.PEEK- A CHAfflfgL_FQR__QUypUT " KERMAL CHKOUT 

This routine must be called before any data is 
sent to any output device. 

HRF LA SA 


* * * 

QEENA CHAWWEL FOR IWPUT - KJBRNAL CHKIN 

This routine is called to define any previously 
opened channel as an input channel. 

HRF TA SA TLKATN 


* * * 

Q_UTRUT_ A^CHABACTER - KERNAL 

This uses a single character buffer and will 
send previously buffered characters if any exists. 
This buffer is also sent along with EOI prior to 
sending any serial bus command sequence (HRF, LA, TA, 
SAO, SAC, SA, UNTLK, UNLSN). 

* * * 

I NEUT A CH A R A CT ER r KERNA L C HKI N/G ET IN 

This routine is called to get a byte of data 
from a channel already setup as an input channel. 

DBc or EOI DBc (if the external device sends an 
EOI) 


* * * 

C LEAR I /P CHANNELS z-MBBLC L BSffli/g LB glflL. 

This routine is used to clear and restore all 
open channels to their default values. 

If a CHKIN channel open was used: UNTLK 

If a CHKOUT channel open was used: EOI DBc HRF 
UNLSN 


* * * 
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CHECK^mJ^SJ^_KB^PRE$3_gD_-__ KERHAI^STOP 
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This routine scans to see if the stop key is 
pressed. If the stop key is pressed the routine calls 
CLRCHN. 


* * * 

STAM PMQ lJS B M A^^ 


LA SA DATA LASTDATA UNLISTEN 


ATN 


ATN EOI-HANDSHAKE SYSTEM 

LINE 

RELEASE 

The data is processed by synchronous transfer 
with pin 4 (CLOCK) on the serial bus. The first bit 
is the LSB and all bits are of 8 bit construction. 

The talk and listen addresses are $48 and $28 
for device eight or $49 and $29 for device nine. 

The secondary address (SA) is $6x , $Fx, or $Ex 
(where x has a value from $00 to $0F). 

Speed: 4,800 to 6,800 baud. 

* * * 

_EAS_T_S_ERIAL l bus protocol 
HRF DRF HRF 


LA SA DATA LASTDATA UNLISTEN 


ATN 


ATN EOI-HANDSHAKE SYSTEM LINE 

RELEASE 

The data is processed by synchronous transfer 
with pin 1 (SRQ) on the serial bus. The first bit is 
the MSB and all bits are of 8 bit construction. The 
minimum bit cell is 6 us. or 48 us. per byte. 
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The talk and listen addresses are $48 and $28 
for device eight or $49 and $29 for device nine. 

The secondary address (SA) is $6x , $Fx, or $Ex 
(where x has a value from $00 to $0F). 

Speed: 21,000 to 23,000 baud. 

* * * 




SRQ 


i i M 
i i M 


i i M 
M M 


i i i i 
I i I I 


M i i 
i II I 


i l i i 
i i II 


DATA 


The data is processed by synchronous transfer 
with pin 1 (SRQ) on the serial bus. The first bit is 
the MSB and all bits are of 8 bit construction. The 
minimum bit cell is 6 us. or 48 us. per byte. 
Handshaking is processed by pin 4 (CLOCK). 

Speed: 78,400 to 80,000 baud. 

* * * 

1581 Bugs 

Soon after it's appearance on the market the 
1581 disk drive was plagued with several unfortunate 
hardware problems that Commodore has since corrected. 

Extensive testing of the 1581 was done and three 
manufacturing problems were corrected. 

The first one involved an improperly grounded 
jumper (Jl) on the PC board inside the 1581 disk 
drive. Allows the drive to use the 6 ms step rate. 

The second involved a bad batch of WD1770 chips 
that were later replaced with the WD1772 chip. A 
typical symptom of this problem is a corrupted 
directory after a disk copy. 

The third involves a bad solder connection of 
pin 10 on device U10. It causes intermitant "device 
not present" errors. 
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Any authorized Commodore repair center can 
repair a 1581 that suffers any of the above problems. 
I'm not positive, but I think they will do these 
repairs whether your drive is in warranty or not. 
Contact your repair center and ask for details on 
repairing the drive and about warranty coverage. 

You can test your drive with a public domain 
diagnostic program called 1581.DIAG or you can open 
the drive up and inspect it's insides yourself. The 
1581.DIAG program was written by a concerned employee 
at Commodore. You can probably find this file on your 
local BBS and it's definitely circulating on most of 
the major telecommunication newtworks. The original 
program requires that you own a Cl28 since it 
contains BASIC 7.0 commands. However, since not 
everyone out there owns a Cl28 I have included a 
public domain version of the diagnostic program that 
will run on both computers. You'll find the program 
on the companion disk called 1581.DIAG.C64. This file 
is provided free of charge as a service to those that 
do not have access to modems or user groups. Feel 
free to share 1581.DIAG.C64 with your friends. 

Using the diagnostic program is easy. Simply 
load and run it from within BASIC 2.0. Now, insert a 
blank diskette into the drive to be tested and follow 
the on screen prompts. 

The results you want to see are: "UNIT X 
CONTAINS A WD1772 AND J1 IS CLOSED. " Please note 
that the program cannot test the status of pin 10 on 
U10. I'm also told that having a WD1770 or WD1772 is 
ok, but if you are experiencing problems with a 
WD1770 switch it to the WD1772. The switch will have 
to be done by a qualified repairman since the WD177X 
controller is not socketed. 

During my explorations of the 1581 disk drive I 
have found only one apparent error in the DOS. The 
routine at $BA64 sets the error vector at $01BA-$01BB 
to point at an unused portion of the ROM that 
contains $FF/255 in hex. The exact location is $DFDF. 
An attempt to execute machine code at that location 
will crash the drive. 

Although I have crashed the drive many times 
while exploring the DOS. I have yet to find a time 
when the routine at $BA64 caused the drive to crash 
by resetting the error vector mentioned above. 
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In the meantime, no other errors have surfaced. 
As a third generation of DOS (1541 to 1571 to 1581) 
the DOS seems to be pretty secure and reliable. If 
you know of any problems or have documented a bug 
please share the information with the rest of us. 

★ * * 

_B_e_a.ching the Author 

This book is the result of many hours of hard 
work that covers a period of nearly 12 months. During 
that time I have spent many hours researching the 
subjects covered in this book. If you find any errors 
or omissions in my memory maps or other parts of the 
book please feel free to contact me in care of: 

Software Support International 
2700 NE Andresen Road #A-1 
Vancouver, WA, USA 98661 

If you write and would like a reply please send 
an SASE. 

If you own an MSD disk drive then you might be 
interested in my book The MSP DOS Reference Guide . It 
contains sections on using and programming the DOS, 
comprehensive RAM and I/O memory maps and a commented 
disassembly of the MSD DOS V2.3. The ONLY MSD DOS 
reference available. Comes complete with a companion 
disk that's full of programs for the MSD drives. 
Contact Software Support International for price and 
availability. 


* * * 

_G_etting_I_nformation on the WPl77x 

Official information on the WD177x series chips 
can be really handy if you plan on heavy programming 
of the 1581 disk drive. Or even if you would just 
like to learn more about the floppy disk controller 
chip then contact Western Digital at: 

Western Digital Corporation 

2445 McCabe Way 

Irvine, California, USA 92714 

Phone: (800)847-6181 or (714)863-0102 

Ask for documentation on the WD1770/1772 5.25" 
Floppy Disk Controller/Formatter. I called and was 
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mailed the information FREE several months ago. I'm 
not sure if the free information policy still stands, 
but just write or call them and find out. 

The documentation they sent me was kind of 
technical so the beginner may not find it as useful 
as more experienced people would. 

* * * 

RECOMMENDED READING 

I suggest that beginners or experts in DOS 
programming read the following books. They are very 
informative and make great reference books. 

Inside Commodore, DOS by Richard Immers and 
Gerald G. Neufeld $19.95 (ISBN 0-8359- 3091-2) 

1571 Internals by Rainer Ellinger 
$19.95 (ISBN 0-916439-44-5) 

The Anatomy of the 154l_D_isk Drive by Lothar 
Englisch and Norbert Szczepanowski $19.95 
(ISBN 0-916439-01-1) 

TJhe_MS_D^(lS_Retej^nc_e^ Guide by David w. Martin 
$29.95 

Commodore^JL581 DiskDrive User's Guide by 
Commodore Business Machines (P/N:319928-01) 
$199.95 (or free with drive purchase - hmmm 
maybe you could buy it separately?i?) 

These books should be available through your 
local book retailer and some mail order companies.I 
recommend them all highly, since without them I would 
not have learned what I know today about Commodore 
disk drives. 


* * * 
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CONSTRUCTION 

Products used to produce this book include: 

HARDWARE, 

Commodore 128D Computer and 1581 Disk Drive 
(The best 8-bit set up ever put together.) 

Commodore Amiga 500 Computer (True 
computing power and YES Amiga does make it 
possible!) 

Hewlett-Packard DeskJet printer (Laser- 
quality output at an affordable price.) 

So ftware, 

WordPerfect 4.1 for the Amiga from 
WordPerfect, Corp. (The best wordprocessor 
on the Amiga.) 

Kracker-Mon from Kracker-Jax (For enjoyable 
disk drive explorations.) 

Super Snapshot V3.0 from LMS, Technologies 
(Great piece of hardware/software. A must 
have item!) 

The text in this book was created using 
WordPerfect on the Amiga. Software and disk 
explorations using the 1581 were completed on the 
C128D computer. The final draft of the book was 
created on the Amiga using the HP DeskJet printer. 

Let the list above be a lesson to everyone. No 
matter what someone says about your computer never 
let them say it can't do everything. Frankly, it can. 

Good software and hardware combinations like the ones 
listed above only prove how true this is. 

T h jahk s _._._._ 

Special thanks to the folks who made this book 
possible. You all were helpful in lighting up some of 
the darker corners within the 1581 DOS and it's inner 
workings. From the West coast to the East coast and 
North to Canada many thanks. 

This book would also not have been possible 
without loud rock music, days off without homework, 
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my parents, my dog Gretel, and my brother 
loud and abrasive editorial comments were 
but largely ignored.) 
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A ppendix A - Sample and Utility Programs 

Loading Sample and Utility Programs 

Loading and executing the sample and utility 
programs on the companion disk is as easy as 1..2..3. 
Simply insert the companion diskette in any drive and 
type: 


LOAD "PROGRAM NAME ", DEV# (HIT RETURN) 

DEV# is any valid drive device number from 8 to 

11 . 

PROGRAM NAME is the name of the file on the disk 
that you wish to LOAD. File names for each of the 
sample and utility programs are given in their 
respective documentation. 

Executing the programs is as easy as loading. If 
an error did not occur during loading then type the 
following after the next READY, message appears: 

RUN (HIT RETURN) 

The loaded program will now execute. See the 
documentation on the following pages for information 
on using the sample and utility programs. 

Note: New users should thoroughly read the 

manuals that accompany their computer and disk 
drives. These books provide detailed information on 
loading and executing files. 

* * * 

Loading Kracker-Mon 

Kracker-Mon can be loaded and executed very 
easily. Simply insert the companion diskette in any 
drive and type: 

LOAD "KRACKER—MON/1581", DEV# (HIT RETURN) 

After the program loads type: 

RUN (HIT RETURN) 

This procedure loads the main Kracker-mon 
program. The main program allows you to create 
different versions of the Kracker-Mon machine 
language monitor and edit the monitor's opcode table. 
See Chapter 5 for detailed instructions. 
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Using the monitors that the above program 
creates is just as easy as loading the main program 
above. Simply type: 

LOAD "MONXOOO", DEV#, 1 (HIT RETURN) 

The program will automatically execute after it 
loads. 


* * * 

_Sj»ap_le_ Program Documentation 
_l_58X_D_iaqnostic Program 
PROGRAM NAME: 1581.DIAG.C64 

This program will check your 1581 disk drive for 
some known hardware errors. 

You will need a formatted diskette to use the 
program. Simply insert this diskette into the drive 
and when prompted enter the device number of the unit 
to be tested. Device numbers range from 8 to 11 
normally. See chapter 9 for information on what the 
diagnostic messages mean. 

* * * 

DOS DUMP 


PROGRAM NAME: DOS DUMP 

This program will dump a copy of a disk drives 
ROM to a diskette. Both 1571 and 1581 drives are 
supported. You will need a blank diskette or one with 
about 200 blocks free. Simply enter the drive number 
you want the ROM download to occur on. The program 
will then download the DOS to a program called DOS 
DUMP. 1000 onto the disk present in the download 
drive. 

The DOS DUMP.1000 file loads into computer 
memory at $1000/4096. It can be explored using 
Kracker-Mon or a suitable disassembler. 

* * * 
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1581 File Lock/Unlock 


PROGRAM NAME: 81FILEL0CK0N.OFF 

This program allows you to lock files so that 
they may not be removed from the diskette using the 
scratch command. 

To use the program, you must know the name of 
the file you wish to lock or unlock before running 
this program. You will be prompted to enter the name 
of the file to be changed and the drive number where 
it currently resides. Afterwards, the program will 
toggle the files lock status. Files that are not 
locked become locked and files that are locked become 
unlocked. 
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This program is an adaptation of a program in 
the public domain for the 1541 and 1571 disk drives. 
Original author unknown. 


* * * 

Program-2-USR File Convertor 
PROGRAM NAME: PRG-2-USR 

This program will convert single block program 
files to files compatible with the DOS command 

format described in chapter 1. It can be used to 
create files that can be used with the command 

and the autoboot feature on the 1581 disk drive. 

The program will create USR files compatible 
with all Commodore drives that support the 
command or autobooting file features. 

Please note that your are limited to using a 
program that is just 252 bytes in length. However, 
clever programmers will use the DOS block-read 
commands to boot up any extra blocks that are 
necessary into the DOS data buffers. 

* * * 

Demo DOS Command, 

PROGRAM NAME: DEMO & CMD 

This program demonstrates the ability of the 
1581 to execute a utility command file. It will 
prompt you for the drive containing the demo files 
and then proceed with the demo. 
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The demo causes the disk error LED to flash 
continuously for a few seconds. Afterwards, the demo 
turns off the error LED by stopping the flashing. The 
demo USR file is called: FLASH LED. 

* * * 

_1^8JL_Autoboot Files._ 

PROGRAM NAME: AUTOBOOT DEMO 

This program demonstrates the ability of the 
1581 to execute an autobooting command file. It will 
prompt you for the drive containing the demo files 
and then proceed with the demo. 

The demo resets the disk drive via the "UJ" 
command. Upon initialization, the 1581 finds a file 
called "COPYRIGHT CBM 86, " which it loads and 
executes within the DOS. The demo file causes the 
disk error LED to flash continuously for a few 
seconds. Afterwards, the demo turns off the error LED 
by stopping the flashing. Stopping the demo is 
accomplished by issuing an "10" command (disk 
initialization). 

* * * 
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A ppendix B__ - 1 581 _ Error Creatpx- 
1581 Err_Qr_Creat_or Description. 


The 1581 Error Creator is a program that allows 
1581 users to create read errors on their 1581 
diskettes. The errors that are created can then be 
used as part of a protection scheme or as a means of 
testing the Error Scanner program on this book's 
companion diskette. 

LOADING THE ERROR CREATOR^ 

Loading the Error Creator is easy. Simply insert 
the companion disk in any drive and type: 

LOAD "81 ERROR CREATOR", DRV# (HIT RETURN) 

DRV# is any legal device number from 8 to 11. 

Now type: 


RUN (HIT RETURN) 


USIN G THE ffiB QB-JgB EA TQB^- 

The following is a command summary that will 
help you to use the 1581 Error Creator. 


CO MMAN D. 

F 


E 


B 


DESCRIPTION 

Format 1581 Diskette (Formats a 
range of tracks with the 
specified error - see below). 

Select error type (None, 20, 23, 
or 27) Appendix C explains the 
error types. 

Starting track (range 1 to 80) to 
format. 


C Ending track (range 1 to 80) to 

format. 

D New Drive (Changes the drive 

number and tells you what type 
of drive it is). Use after 
running the error creator to set 
the drive type. 
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COMMAND 

Q 

X 

F1/F3 


_DESCRIPTION 

Exit to BASIC (Does not confirm 
your exit request, but exits 
immediately after hitting "Q"). 

Send Disk command (ex. 10 will 
initialize the drive). 

Displays a disk directory (SPACE 
pauses while STOP aborts) 

* * * 


J« QTE3_OJW_THE 1581 ERROR CREATOR 

The 1581 Error Creator is a great tool for 
learning and exploring disk protection schemes on the 
1581. It's an advanced tool that must be used with 
caution. 

As an advanced tool the 1581 Error Creator is 
not a toy, so be very careful when using it around 
important diskettes. It's a good idea to write 
protect diskettes containing important data, since 
once an error is created on a track the original data 
is not recoverable. 

If you'd like to attempt to create other types 
of read errors then I suggest you study the drive 
code present in the Error Creator. Manipulating the 
data within can produce all kinds of results. Jump in 
with both feet and enjoy yourself if you discover a 
new and interesting use of this program please let me 
know. 


The 1581 Error Creator was provided courtesy of 
KRACKER JAX, a division of Software Support 
International. 1581 Error Creator was written by Mike 
Howard. Thanks guys for another wonderful tool. 
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Appendix C - Programmi ng the 1581 Job Queue 
_JL 581 Controller Job Queue 

The 1581 Disk Drive User's Guide (UG) describes 
the DOS in ROM as a sort of split personality. This 
personality split is denoted by the two major 
components that make up the ROM DOS: the DOS and the 
Controller. 

The DOS as a collective entity is a complex 
machine language program, that performs many 
important and complex functions. Such as 
communications with the host computer system and 
management of information storage on the diskette. 
Information management allows the DOS to create, 
modify and delete data contained in files on the 
disk. 


The Controller is the part of the DOS that does 
not care about files as a whole. It deals with disk 
data on a very basic and physical level. It's only 
concern is for the reading and writing of individual 
sectors on the diskette. 

The DOS and Controller communicate through what 
is known as the 1581 Job Queue. The Job Queue is a 
collection of memory registers in the drive that act 
as ,, mailboxes ,, according to the 1581 UG. 

These "mailboxes" are scanned or polled 
periodically for Job Queue commands. The actual 
scanning or polling takes place every 10ms. According 
to the 1581 UG the timing is controlled by timer B on 
the 8520. 

If a job is found in the Job Queue it will be 
executed and a value will be returned to the DOS. The 
returned value is the job's status byte. It will tell 
you if the job was successful or not. 

The job queue can be accessed directly or via 
the DOS routine called JSTROBECTRLER. 

Most Job Queue commands require parameters to 
operate correctly. The following pages will show you 
how to use each of the 1581's Controller Job command 
codes. This includes setting up the commands and 
example DOS programs. 

The memory map below lists the important memory 
locations that a user needs to know if he or she 
plans to program the 1581's disk controller. 
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LOCATION IN HEX 
$0002 - $0008 


$0009 - $000A 


$000B - $001C 


$008B - $008C 
$009F - $00A7 


$01BC - $01CD 


$01CE - $01D6 


$0C00 - $1FFF 


^DESCRIPTION 

Job Queue Controller 
commands for jobs 0 to 6. 
Each job uses 1 byte. 

Job Queue Controller 
commands for jobs 7 to 8. 
Used for BAM jobs only. 
Each job uses 1 byte. 

Logical or physical track 
and sector for jobs 0 to 8 
listed above. Each job uses 
2 bytes. 

Pointer to track cache 
buffer 

Contains the offset pointer 
that points into the track 
cache buffer for jobs 0 to 
8 listed above. Each job 
uses 1 byte. 

Translated (physical) track 
and sector for jobs 0 to 8 
listed above. Each job uses 
2 bytes. 

Contains the physical side 
for each of the jobs 0 to 8 
listed above. Each job uses 
1 byte. 

Track cache buffer 


Note: See the RAM memory map in Chapter 6 for 
job queue buffer addresses and other interesting RAM 
memory locations. 


* * * 

Basic l 581 _^optmlle£_CalI^_ 

The basic controller call must contain the 
following steps: 

1) Set up any parameters that are required by 
the job command being used. Such as track and 
sector information and/or disk side. 
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2) Write the job controller code into the 
appropriate job queue. 

3) Wait for the job to finish it's execution. 

4) Retrieve the job's status from the job queue. 

The steps listed above present Controller 
programming in a nutshell. For the most part all the 
steps are important particularly step number one. 

Step one involves setting up the disk Controller 
hardware to perform a specified operation on a 
particular track and sector or an entire track. It is 
very important to make sure that the information you 
use to set up the Controller electronics is correct. 
The Controller does not check the information given 
to it for errors (except illegal Controller 
commands). As far as track and sector parameters are 
concerned the Controller will do exactly what you 
tell it. 

Therefore, it is important to stay within the 
allowable track and sector range when programming the 
DOS. Reading or writing beyond the allowable track 
range of 1 to 80 will cause unpredictable results and 
is not recommended. While accessing tracks past track 
80 is not recommended it may be possible to access 
tracks as high as track 85 on the 1581. 

Step two is performed after setting up the job 
queue. This is where you tell the drive what to do at 
the specified track and sector. Simply store a 
Controller command code in the job queue and watch 
the drive work. 

Afterwards, steps three and four give you the 
status of the job being executed. If you load the 
value from the currently active job and bit seven is 
set to one then that job has not completed execution. 
When bit seven is reset to zero the job has completed 
it's execution. Loading the value from the previously 
active job gives you the command status. 

* * * 
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The command status 
the following chart: 

Status Code 

$ 00/$01 

$02 

$03 

$04 

$05 

$06 

$07 

$08 

$09 

$0A 

$0B 

$0C 

$0D 

$0E 

$0F 


is determined according to 

_De s c? r . i j^ i on_. 

No error occurred 

Cannot find header block 

No address mark was detected 

Data block was not present 

CRC error found in data 
block 

Disk format error 

Disk verify error 

Write protect error (disk 
was write protected) 

CRC error found in header 
block 

Usage reserved 

Disk changed flag/Disk ID 
mismatch 

Disk format was not logical 

Floppy Disk controller error 

Syntax error/invalid job 
number 

No disk present in disk 
drive 

* * * 


_Ji^8JL_JQ-b_-C-Qjntro^^ 

— a n d . Examp l e s . 

The following sample job queue programming 
samples are located in job queue buffer number one at 
$0400. They use job queue buffer number zero ($0300) 
as a data buffer. The data read or written to the 
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o 

w 


disk involves the first sector of the directory 
track. Therefore do not run these routines with an 
important diskette in the drive. Use only a blank 
formatted diskette for experimenting. 

Command Name : READ_DV 

Command Code: $80 

Command Description: Reads a logical sector into the 

job queue buffer. 

Command Example: 0400 LDA #$28 ; TRK # 40 

LDX #$00 ; SEC # ZERO 

STA $0B ? JOB 0 TRK PARAM 

STX $0C ; JOB 0 SEC PARAM 

LDA #$80 ; JOB 0 COMMAND 

STA $02 ; JOB 0 COMMAND EXEC 

LOOP LDA $02 ; WAIT TIL JOBS DONE 

BMI LOOP 

RTS ? JOB COMPLETED 

NOTE: The accumulator contains the status byte when 
the job is completed. 


Command Name: WRTSD_DV 
Command Code: $90 

Command Description: Write the job queue buffer to 

the specified track and sector. 

Command Example: 0400 LDA #$28 ; TRK # 40 

LDX #$00 ; SEC # ZERO 

STA $0B ? JOB 0 TRK PARAM 

STX $0C ; JOB 0 SEC PARAM 

LDA #$90 ? JOB 0 COMMAND 

STA $02 ; JOB 0 COMMAND EXEC 

LOOP LDA $02 ; WAIT TIL JOBS DONE 

BMI LOOP 

RTS ; JOB COMPLETED 

NOTE: The accumulator contains the status byte when 
the job is completed. 
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Command Name: WRTVER_DV 
Command Code: $AO 


Command Description: Verify track cache buffer data 

against a logical track's data. 


Command Example: 0400 LDA #$28 

LDX #$00 
STA $0B 
STX $0C 
LDA #$A0 
STA $02 
LOOP LDA $02 
BMI LOOP 
RTS 


TRK # 40 

SEC # ZERO 

JOB 0 TRK PARAM 

JOB 0 SEC PARAM 

JOB 0 COMMAND 

JOB 0 COMMAND EXEC 

WAIT TIL JOBS DONE 

JOB COMPLETED 


NOTE: The accumulator contains the status byte when 
the job is completed. 


* * * 


Command Name: SEEKHD_DV 
Command Code: $B0 

Command Description: Log in a disk by reading the 

information from the first 
header found. Does not update 
the track cache buffer. 


Command Example: 


0400 LDA #$B0 
STA $02 
LOOP LDA $02 
BMI LOOP 
RTS 


; JOB 0 COMMAND 
; JOB 0 COMMAND EXEC 
7 WAIT TIL JOBS DONE 

7 JOB COMPLETED 


NOTE: The accumulator contains the status byte when 
the job is completed. 


* * * 
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Command Name: RESTORE DV 


Command Code: $C0 

Command Description: Bumps the Read/Write head to 

track 0. 


Command Example: 0400 
LOOP 


LDA #$C0 
STA $02 
LDA $02 
BMI LOOP 
RTS 


7 JOB 0 COMMAND 
7 JOB 0 COMMAND EXEC 
7 WAIT TIL JOBS DONE 

7 JOB COMPLETED 


NOTE: The accumulator contains the status byte when 
the job is completed. 


* * * 


Command Name: JUMPC_DV 
Command Code: $D0 


Command Description: Executes machine language 

program code in the specified 
job queue buffer. 


Command Example: 


0400 LDA #$D0 
STA $02 
LOOP LDA $02 
BMI LOOP 
RTS 


? JOB 0 COMMAND 
7 JOB 0 COMMAND EXEC 
? WAIT TIL JOBS DONE 

? JOB COMPLETED 


NOTE: The accumulator contains the status byte when 
the job is completed. The code begins to execute at 
$0300 in the example above. The code to be executed 
must have been previously loaded into the job queue 
buffer. 


* * * 


Command Name: EXBUF_DV 
Command Code: $E0 

Command Description: Executes machine language 

program code in the specified 
job queue buffer, but waits 
until the drive motor is on and 
up to speed and the read/write 
head is in place. 
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Command Example: 0400 LDA #$E0 ; JOB 0 COMMAND 

STA $02 ; JOB 0 COMMAND EXEC 

LOOP LDA $02 7 WAIT TIL JOBS DONE 

BMI LOOP 

RTS ? JOB COMPLETED 

NOTE: The accumulator contains the status byte when 
the job is completed. The code begins to execute at 
$0300 in The example above. The code to be executed 
must have been previously loaded into the job queue 
buffer. 


Command Name: RESET__DV 
Command Code: $82 

Command Description: Resets the disk drive Controller 

and RAM variables. 

Command Example: 0400 LDA #$82 ? JOB 0 COMMAND 

STA $02 ; JOB 0 COMMAND EXEC 

LOOP LDA $02 ; WAIT TIL JOBS DONE 

BMI LOOP 

RTS ? JOB COMPLETED 

NOTE: The accumulator contains the status byte when 
the job is completed. 


Command Name: MOTON_DV 
Command Code: $84 

Command Description: Turns on the drive spindle motor 

and places a $01 in the job 
queue after the spin-up 
sequence is complete. 

Command Example: 0400 LDA #$84 ? JOB 0 COMMAND 

STA $02 ; JOB 0 COMMAND EXEC 

LOOP LDA $02 ; WAIT TIL JOBS DONE 

BMI LOOP 

RTS ? JOB COMPLETED 

NOTE: The accumulator contains the status byte when 
the job is completed. 
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Command Name: MOTOFF DV 


Command Code: $86 


Command Description: Turns the drive spindle motor 

off after the spin-down 
sequence is complete. 


Command Example: 


0400 LDA #$86 
STA $02 
LOOP LDA $02 
BMI LOOP 
RTS 


; JOB 0 COMMAND 
? JOB 0 COMMAND EXEC 
? WAIT TIL JOBS DONE 

; JOB COMPLETED 


NOTE: The accumulator contains the status byte when 
the job is completed. 


* * * 


Command Name: MOTONI DV 


Command Code: $88 


Command Description: 


Spindle motor on immediately. 


Command 


Example: 0400 LDA #$88 
STA $02 
LOOP LDA $02 
BMI LOOP 
RTS 


; JOB 0 COMMAND 
? JOB 0 COMMAND EXEC 
; WAIT TIL JOBS DONE 

; JOB COMPLETED 


NOTE: The accumulator contains the status byte when 
the job is completed. 


* * * 


Command Name: MOTOFFI_DV 
Command Code: $ 8A 

Command Description: Spindle motor off immediately. 

Command Example: 0400 LDA #$8A ; JOB 0 COMMAND 

STA $02 ; JOB 0 COMMAND EXEC 

LOOP LDA $02 ; WAIT TIL JOBS DONE 

BMI LOOP 

RTS ; JOB COMPLETED 

NOTE: The accumulator contains the status byte when 
the job is completed. 


* * * 
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Command Name: SEEK DV 
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Command Code: $8C 


Command Description: Looks for a particular physical 

track (or cylinder). The 
current physical track is in 
memory at $0027. 


Command Example: 


0400 LDA #$27 
LDY #$00 
STA $01BC 
STY $01CE 
LDA #$8C 
STA $02 
LOOP LDA $02 
BMI LOOP 
RTS 


PHYSICAL TRK 27 
SIDE 0 

SET PHYSICAL TRK 
SET DISK SIDE 
JOB 0 COMMAND 
JOB 0 COMMAND EXEC 
WAIT TIL JOBS DONE 

JOB COMPLETED 


NOTE: The accumulator contains the status byte when 
the job is completed. 


* * * 


Command Name: FORMAT DV 


Command Code: $8E 

Command Description: Physical track format (formats 

half a cylinder) read/write 
head must be over the track to 
be formatted and the side must 
be selected. 

Command Example: ? POSITION THE READ/WRITE HEAD 


0400 LDA #$27 
LDY #$00 
STA $01BC 
STY $01CE 
LDA #$8C 
STA $02 
LOOP LDA $02 
BMI LOOP 


PHYSICAL TRK 27 
SIDE 0 

SET PHYSICAL TRK 
SET DISK SIDE 
JOB 0 COMMAND 
JOB 0 COMMAND EXEC 
WAIT TIL JOBS DONE 


; FORMAT THE PHYSICAL TRK CURRENTLY 
; UNDER THE READ/WRITE HEAD 


; JOB 0 COMMAND 
? JOB 0 COMMAND EXEC 
? WAIT TIL JOBS DONE 


LDA #$8E 
STA $02 
LOOP LDA $02 
BMI LOOP 
RTS 


? JOB COMPLETED 
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NOTE: The accumulator contains the status byte when 
the job is completed. 


* * * 


Command Name: DISKIN DV 


Command Code: $92 

Command Description: Checks to see if a disk is 

inserted into the drive. 


Command Example: 


0400 LDA #$92 
STA $02 
LOOP LDA $02 
BMI LOOP 
RTS 


? JOB 0 COMMAND 
? JOB 0 COMMAND EXEC 
; WAIT TIL JOBS DONE 

; JOB COMPLETED 


NOTE: The accumulator contains the status byte when 
the job is completed. If the status byte is anything 
other then $00 or $01 then no disk is in the disk 
drive. 


* * * 


Command Name: LEDACTON__DV 
Command Code: $94 


Command Description: Turn on the drive activity LED. 


Command Example: 


0400 LDA #$94 
STA $02 
LOOP LDA $02 
BMI LOOP 
RTS 


; JOB 0 COMMAND 
; JOB 0 COMMAND EXEC 
; WAIT TIL JOBS DONE 

; JOB COMPLETED 


NOTE: The accumulator contains the status byte when 
the job is completed. 

* * * 
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Command Name: LEDACTOFF DV 
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Command Code: $96 


Command Description: Turn off the drive activity LED. 


Command 


Example: 0400 LDA #$96 
STA $02 
LOOP LDA $02 
BMI LOOP 
RTS 


; JOB 0 COMMAND 
; JOB 0 COMMAND EXEC 
; WAIT TIL JOBS DONE 

? JOB COMPLETED 


NOTE: The accumulator contains the status byte when 
the job is completed. 


* * * 


Command Name: ERRLEDONJDV 
Command Code: $98 


Command Description: Turn on the drive error LED 

(blinking). 


Command Example: 0400 
LOOP 


LDA #$98 
STA $02 
LDA $02 
BMI LOOP 
RTS 


? JOB 0 COMMAND 
; JOB 0 COMMAND EXEC 
; WAIT TIL JOBS DONE 

? JOB COMPLETED 


NOTE: The accumulator contains the status byte when 
the job is completed. 


* * * 

Command Name: ERRLEDOFF_DV 
Command Code: $9A 


Command Description: Turn off the drive error LED 

(not blinking). 


Command 


Example: 0400 LDA #$9A 
STA $02 
LOOP LDA $02 
BMI LOOP 
RTS 


; JOB 0 COMMAND 
; JOB 0 COMMAND EXEC 
; WAIT TIL JOBS DONE 

? JOB COMPLETED 


NOTE: The accumulator contains the status byte when 
the job is completed. 


* * * 
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Command Name: SIDE_DV 
Command Code: $9C 

Command Description: Sets the side select electronics 

to the value specified in the 
current job queue side 
parameter. 

Command Example: 0400 LDA #$00 ; SIDE 0 

STA $01CE ? SET SIDE JOB 0 

LDA #$9C ; JOB 0 COMMAND 

STA $02 ; JOB 0 COMMAND EXEC 

LOOP LDA $02 ? WAIT TIL JOBS DONE 

BMI LOOP 

RTS ; JOB COMPLETED 

NOTE: The accumulator contains the status byte when 
the job is completed. 

* * * 

Command Name: BUFMGVE__DV 
Command Code: $9E 

Command Description: Moves data between the job queue 

buffers and the track cache 
buffer. 

Command Example: Not available 

NOTE: This command does not function as described in 
the 1581 User's Guide. Repeated attempts to use this 
command resulted in no action by the drive to copy 
anything anywhere. The User Guide's instructions on 
how to use this command are either faulty or the 
command itself does not work. 

Substitute: The following machine language programs 
can be used to copy data to and from a 
job queue buffer and the track cache 
buffer. 


? COPY DATA FROM JOB QUEUE BUFFER 
? TO TRK CACHE BUFFER 

0400 LDY #$00 

LOOP LDA $0300,Y ? JOB 0 BUFFER 
STA $0C00,Y ? TRK CACHE 
INY 

CPY #$00 
BNE LOOP 
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RTS 


; COPY DATA FROM THE TRK CACHE 
? BUFFER TO THE JOB QUEUE BUFFER 

0400 LDY #$00 

LOOP LDA $0C00,Y ; TRK CACHE 

STA $0300,Y ? JOB 0 BUFFER 
INY 

CPY #$00 
BNE LOOP 
RTS 

* * * 


Command Name: TRKWRT_DV 
Command Code: $A2 


Command Description: Dumps the track cache buffer to 

disk if the track cache 
modified flag is set. 


Command Example: 


0400 LDA #$A2 
STA $02 
LOOP LDA $02 
BMI LOOP 
RTS 


; JOB 0 COMMAND 
; JOB 0 COMMAND EXEC 
; WAIT TIL JOBS DONE 

? JOB COMPLETED 


NOTE: The accumulator contains the status byte when 
the job is completed. 


* 


* * 


Command Name: SP READ 


Command Code: $A4 

Command Description: Reads the selected physical 

sector into drive RAM at $0300 
in buffer number 0. The track 
cache is not used and the 
sector is always read from the 
disk. 


Command Example: 


,0400 LDA #$27 
LDX #$01 
LDY #$00 
STA $0B 
STX $0C 
STY $01CE 
LDA #$A4 
STA $02 


PHYSICAL TRK 0 
PHYSICAL SEC 0 
SIDE 0 

SET PHYSICAL TRK 
SET PHYSICAL SEC 
SET DISK SIDE 
JOB 0 COMMAND 
JOB 0 COMMAND EXEC 
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LOOP LDA $02 ; WAIT TIL JOBS DONE 

BMI LOOP 

RTS ; JOB COMPLETED 

NOTE: The accumulator contains the status byte when 
the job is completed. The contents of $0B/$0C are 
copied to $01BC/$01BD when the command is executed. 


Command Name: SP_WRITE 
Command Code: $A6 

Command Description: Writes the selected physical 

sector from drive RAM at $0300 
in buffer number 0. The track 
cache is not used. 

Command Example: 0400 LDA #$27 ? PHYSICAL TRK 0 

LDX #$01 7 PHYSICAL SEC 0 

LDY #$00 7 SIDE 0 

STA $0B ? SET PHYSICAL TRK 

STX $0C ? SET PHYSICAL SEC 

STY $01CE 7 SET DISK SIDE 

LDA #$A6 ? JOB 0 COMMAND 

STA $02 7 JOB 0 COMMAND EXEC 

LOOP LDA $02 7 WAIT TIL JOBS DONE 

BMI LOOP 

RTS ? JOB COMPLETED 

NOTE: The accumulator contains the status byte when 
the job is completed. The contents of $0B/$0C are 
copied to $01BC/$01BD when the command is executed. 


Command Name: PSEEK_DV 

Command Code: $A8 

Command Description: Seeks the selected physical 

track. 

Command Example: 0400 LDA #$27 7 PHYSICAL TRK 0 

LDX #$01 7 PHYSICAL SEC 0 

LDY #$00 ? SIDE 0 

STA $0B ? SET PHYSICAL TRK 

STX $0C ? SET PHYSICAL SEC 

STY $01CE 7 SET DISK SIDE 

LDA #$A8 ? JOB 0 COMMAND 

STA $02 ? JOB 0 COMMAND EXEC 

LOOP LDA $02 ? WAIT TIL JOBS DONE 
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JOB COMPLETED 


n> 




r> 




o 


BMI LOOP 


r> 


RTS 

; JOB COMPLETED 

o 

NOTE: The accumulator contains the status byte when 

r\ 

the job is completed. The contents of $OB/$OC are 
copied to $01BC/$01BD when the command is executed. 

n 


* * * 


r\ 




rs 

Command Name: TREAD_DV 


n 

Command Code: $AA 



o 




n 

Command Description: 

Reads a logical address without 


transfer to 

the buffer used by 

r\ 


the job queue. 

rs 

Command Example: 0400 

LDA #$28 

LOGICAL TRK 28 

r> 


LDX #$01 

LOGICAL SEC 0 



LDY #$00 

SIDE 0 



STA $0B 

SET LOGICAL TRK 

rs 


STX $0C 

SET LOGICAL SEC 

rs 


STY $01CE 

SET DISK SIDE 


LDA #$AA 

JOB 0 COMMAND 

r 


STA $02 

JOB 0 COMMAND EXEC 

r 

LOOP 

LDA $02 

BMI LOOP 

WAIT TIL JOBS DONE 

o 


RTS 

JOB COMPLETED 

n 

NOTE: The accumulator contains the status byte when 

r 

the job is completed. 

* * * 


r 




r 

Command Name: TWRT_DV 



rs 

Command Code: $AC 



r 

Command Description: 

Writes a logical address without 

rs 

transfer to 

the buffer used by 

r> 

the job queue. 

rs 

Command Example: 0400 

LDA #$28 

LOGICAL TRK 28 

rs 


LDX #$00 

LOGICAL SEC 0 


LDY #$00 

SIDE 0 

rs 


STA $0B 

SET LOGICAL TRK 



STX $0C 

SET LOGICAL SEC 

r 


STY $01CE 

SET DISK SIDE 

rs 


LDA #$AC 

JOB 0 COMMAND 



STA $02 

JOB 0 COMMAND EXEC 

rs 

LOOP 

LDA $02 

WAIT TIL JOBS DONE 

r 


BMI LOOP 


rs 


RTS 

JOB COMPLETED 

r 




r 
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NOTE: The accumulator contains the status byte when 
the job is completed. 

* * * 

Command Name: TPREAD_DV 
Command Code: $B2 

Command Description: Reads a physical address without 

transfer to the buffer used by 
the job queue. 

Command Example: 0400 LDA #$27 ? PHYSICAL TRK 27 

LDX #$01 ? PHYSICAL SEC 1 

LDY #$00 ; SIDE 0 

STA $0B ? SET PHYSICAL TRK 

STX $0C ; SET PHYSICAL SEC 

STY $01CE ? SET DISK SIDE 

LDA #$B2 ? JOB 0 COMMAND 

STA $02 ? JOB 0 COMMAND EXEC 

LOOP LDA $02 ; WAIT TIL JOBS DONE 

BMI LOOP 

RTS ? JOB COMPLETED 

NOTE: The accumulator contains the status byte when 
the job is completed. The contents of $0B/$0C are 
copied to $01BC/$01BD when the command is executed. 


Command Name: TPWRT_DV 
Command Code: $B4 

Command Description: Writes a physical address 

without transfer to the buffer 
used by the job queue. 

Command Example: 0400 LDA #$27 ? PHYSICAL TRK 27 

LDX #$01 ; PHYSICAL SEC 1 

LDY #$00 ; SIDE 0 

STA $0B ; SET PHYSICAL TRK 

STX $0C ; SET PHYSICAL SEC 

STY $01CE ; SET DISK SIDE 

LDA #$B4 ; JOB 0 COMMAND 

STA $02 ; JOB 0 COMMAND EXEC 

LOOP LDA $02 ; WAIT TIL JOBS DONE 

BMI LOOP 

RTS ? JOB COMPLETED 

NOTE: The accumulator contains the status byte when 
the job is completed. The contents of $0B/$0C are 
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n 



n 



n 

copied to $01BC/$01BD when the 

command is executed. 

n 

Command Name: DETWP_DV 





n 

Command Code: $B6 



Command Description: Checks to 

see if the disk in the 

n 

drive is 

write protected. 


Command Example: 0400 LDA #$B6 

; JOB 0 COMMAND 

n 

STA $02 

; JOB 0 COMMAND EXEC 

LOOP LDA $02 

? WAIT TIL JOBS DONE 

n 

BMI LOOP 


n 

RTS 

; JOB COMPLETED 

n 

r\ 

NOTE: The accumulator contains the status byte when 
the job is completed. The status byte returns $08 is 

the disk is write protected, 

otherwise it returns a 

O 

$00. 


r\ 

* * * 



Command Name: FORMATDK_DV 


n 



n 

Command Code: $F0 


n 

Command Description: Formats 

a diskette using the 


default physical format. 

n) 

Command Example: 0400 LDA #$F0 

? JOB 0 COMMAND 

n 

STA $02 

? JOB 0 COMMAND EXEC 

LOOP LDA $02 

; WAIT TIL JOBS DONE 

n 

BMI LOOP 


n 

RTS 

? JOB COMPLETED 

n 

NOTE: The accumulator contains the status byte when 

/•^ 

the job is completed. 


rs 

* * * 


r*^ 

Another aspect of programming the 1581 disk 

rs 

drive is Commodore's "Kernal” 

jump table in the 1581 

rs 

Operating System ROMs. The jump table provides a 

permanent bridge to the major 

DOS routines that will 

n 

not change from one version of 

the DOS to the next. 

n 

Commodore recommends their use, since direct ROM 

o 

r\ 

calls may not be compatible with future DOS releases. 
The jump table provides a way of keeping programs 
compatible with the current version of the 1581 DOS 

n 

and any future revisions. It is good programming 

r*\ 

practice to use the jump table. 


n 



o 
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u 

u 



DOS Kernel 

Jump Table 

U 

The 

jump table and 

it's functions are listed 

u 

below: 



u 

NAME 

LOCATION 

DESCRIPTION— 

u 

JIDLE 

$FFOO 

Main idle loop. Waits 

u 



for disk activity. 


JIRQ 

$FF03 

DOS interrupt routine. 

o 



An interrupt occurs 




when any of the 

l J 



following occur: 





u 



ATN goes low, Fast 

t ) 



serial byte is 




shifted in, 




timeout on a timer 




and the execution 

J 



of a B R K 




instruction. 


JNMI 

$FF06 

This command does a 




"soft” reset. Defaults 




are restored. Autoboot 




file is executed if 

{J 



present, RAM and ROM 




checksums are done. 

o 



and the device 




number switches are 




read ; 

<J 




o 

JVERDIR 

$FF09 

DOS VALIDATE command 





u 

JINTDRV 

$FFOC 

DOS INITIALIZE command 

u 

JPART 

$FFOF 

DOS PARTITION command 

o 

JMEM 

$FF12 

DOS MEMORY commands 

VJ 




u 

JBLOCK 

$FF15 

DOS BLOCK commands 

u 

JUSER 

$FF18 

DOS USER commands 

u 

JRECORD 

$FF1B 

DOS RECORD command 

u 




u 

JUTLLODR 

$FF1E 

DOS UTILITY LOADER 




command 

o 




u 

JDSKCPY 

$FF21 

DOS COPY command 

u 

JRENAME 

$FF24 

DOS RENAME command 

u 


___ u 
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NAME 

LOCATION 

DESCRIPTION 






JSCRTCH 

$FF27 

DOS SCRATCH command 

n 

JNEW 

$FF2A 

DOS NEW/FORMAT command 


ERROR 

$FF2D 

DOS controller error 




handler 


JATNSRV 

$FF30 

ATN server for the 




serial bus 


JTALK 

$FF33 

Talk routine for the 

n 



serial bus 


JLISTEN 

$FF36 

Listen routine for the 




serial bus 

n 

JLCC 

$FF39 

DOS controller routine 

rn 

JTRANS_TS 

$FF3C 

Translation routine for 




logical to physical 




sector translations 

r*s 

CMDERR 

$FF3F 

Handles DOS errors 

n 

JSTROBE CTRLER $FF54 

Call the job controller 




directly 

r^ 

JCBMBOOT 

$FF57 

CBM Autoloader routine 

Routine to return from 

J C BMBOOTRTN 

$FF5A 




the autoloader with 




the autoloader 

r i 



disabled (stops the 

n 



autoloader from doing 




an endless repeat). 


JSIGNATURE 

$FF5D 

ROM signature analysis 

r*\ 



routine 

n s 

JDEJAVU 

$FF60 

Switch for autoloader 




boot on initialization 

o 



or burst 

r> 



inquire/query. Calling 

n 



this routine with the 
carry flag set turns 

r*s 



the autoloader on. 

r^ 



Clearing the carry 
flag turns the 

r\ 



autoloader off. 

n 




o 




n 
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JSPINOUT 


$FF63 


JALLOCBUFF $FF66 


SETFORMAT $FF69 


DUMPTRK $FF6C 


Sets up the fast 
serial direction as 
input or output. 
Calling this routine 
with the carry flag 
sets the serial 
direction as output. 
If the carry flag is 
cleared then the 
serial direction is 
set as input. 


Routine to 
buffers. 
routine 
buf f er 
allocate 
register. 
0, etc.) 


allocate RAM 
Call this 
with the 
number to 
in the A 
(1= buffer 


Routine to setup 
variables for normal 
disk format. 


Routine to dump the 
track cache to 
diskette. 
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